aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorTeddy Wing2016-07-22 22:04:00 -0400
committerTeddy Wing2016-07-22 22:04:00 -0400
commitb247c9a849f458273d1d01ccc7b96d210ae142fd (patch)
treed4c36d004e0c9a4fb5374e11961454171ed94994 /README.md
parent76389e82bcb37d59173bb29de63b190640946beb (diff)
downloadqcd-b247c9a849f458273d1d01ccc7b96d210ae142fd.tar.bz2
Add README.md
Include a short description, example usage information, installation instructions, and license information.
Diffstat (limited to 'README.md')
-rw-r--r--README.md39
1 files changed, 39 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..67144a7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,39 @@
+qcd
+===
+
+A Bash utility that enables quick `cd`s using shortcuts.
+
+
+## Example
+
+ $ cd code/qcd
+
+ # Add a shortcut `qcd` for the current directory
+ $ qcd -a qcd .
+
+ $ cd ~/Desktop/
+ $ qcd qcd
+ $ pwd
+ /Users/professorfarnsworth/code/qcd
+
+ $ qcd -a another-project ../another-project-dir/
+ $ qcd another-project
+ $ pwd
+ /Users/professorfarnsworth/code/another-project-dir
+ $ qcd qcd
+ $ pwd
+ /Users/professorfarnsworth/code/qcd
+
+ # Remove the `another-project` shortcut
+ $ qcd -r another-project
+
+
+## Install
+Grab the code and add the following lines to your Bash profile:
+
+ source ~/path/to/qcd
+ source ~/path/to/qcd.bash-completion
+
+
+## License
+Copyright © 2016 Teddy Wing. Licensed under the GNU GPLv3+ (see the included COPYING file).