Git
/
cheat
mirror of https://github.com/cheat/cheat.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Updated the README.

This commit is contained in:
Chris Lane 2013-08-11 15:57:11 -04:00
parent 431cde776c
commit b2fe140fdb
1 changed files with 13 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
README.md
View File

@ -1,7 +1,7 @@
cheat cheat
===== =====
`cheat` allows you to create and view interactive cheatsheets on the `cheat` allows you to create and view interactive cheatsheets on the
command-line. It was designed to help \*nix system administrators remember command-line. It was designed to help remind \*nix system administrators of
options for commands that they use frequently, but not frequently enough to options for commands that they use frequently, but not frequently enough to
remember. remember.
@ -9,6 +9,7 @@ remember.
`cheat` depends only on python. `cheat` depends only on python.
Examples Examples
-------- --------
The next time you're forced to disarm a nuclear weapon without consulting The next time you're forced to disarm a nuclear weapon without consulting
@ -52,8 +53,8 @@ Do the following to install `cheat`:
2. Run `sudo ./install` 2. Run `sudo ./install`
The `install` script will copy a python file into `/usr/local/bin/`, and will The `install` script will copy a python file into `/usr/local/bin/`, and will
also create a hidden file (containing the cheatsheet content) in your home also create a hidden `.cheat` folder (containing the cheatsheet content) in
directory. your home directory.
Modifying Cheatsheets Modifying Cheatsheets
@ -62,14 +63,17 @@ The value of `cheat` is that it allows you to create your own cheatsheets - the
defaults are meant to serve only as a starting point, and can and should be defaults are meant to serve only as a starting point, and can and should be
modified. modified.
To modify your cheatsheets, edit the `~/.cheat` file, which simply contains a Cheatsheets are stored in the `~/.cheat/` directory, and are named on a
python dictionary. To add new cheatsheets, you need only append new key/value per-keyphrase basis. In other words, the content for the `tar` cheatsheet lives
pairs to the dictionary. in the `~/.cheat/tar` file. To add a cheatsheet for a `foo` command, you would
create file `~/.cheat/foo`, whereby that file contained the cheatsheet content.
Note that `cheat` supports subcommands, such that (for example) `git` and `git Note that `cheat` supports "subcommands" simply by naming files appropriately.
commit` may each be assigned their own cheatsheets. Thus, if you wanted to create a cheatsheet not only (for example) for `git` but
also for `git commit`, you could do so be creating cheatsheet files of the
appropriate names (`git` and `git commit`).
After you've customized your cheatsheets, I urge you to track `.cheat` along After you've customized your cheatsheets, I urge you to track `~/.cheat/` along
with your [dotfiles][]. with your [dotfiles][].