]> git.madduck.net Git - code/vcsh.git/blobdiff - INSTALL.md

madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://git.madduck.net/madduck/pub/<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to patches@git.madduck.net. If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://git.madduck.net/madduck/"]
  insteadOf = madduck:

Better debugging
[code/vcsh.git] / INSTALL.md
index c69c010288e0c22a829076739a9733fe7ffe7a4b..29c9889194866fd66a256374e406a799cdd2dd7b 100644 (file)
@@ -1,36 +1,45 @@
 # Pre-requisites #
 
-If you want to build the manpage, you will need ronn. Newer versions of Debian come with a package:
+If you want to build the manpage, you will need [ronn] [1].
+Debian 7.0 and above come with a package, so do most Debian clones.
 
-    apt-get install ruby-ronn
+To install ronn on your Debian-based system, simply run
+
+       apt-get install ruby-ronn
+
+There are no other dependencies other than `git`, `ronn` and a POSIX shell.
 
 
 # Installing #
 
-    sudo make install
+       sudo make install
 
 
 # Uninstalling #
 
-    sudo make uninstall
+       sudo make uninstall
 
-There is another, more thorough, version. Just make sure you are not running this when you have installed to an important directory which is empty, otherwise.
+There is another, more thorough, version. Just make sure you are not running
+this when you have installed to an important directory which is empty,
+otherwise.
 
-**THIS WILL DELETE /usr/local IF YOU INSTALLED THERE AND IT'S EMPTY, OTHERWISE**
+**THIS WILL DELETE /usr/local IF YOU INSTALLED THERE AND IT BECOMES EMPTY**
 
-    sudo make purge
+       sudo make purge
 
-**THIS WILL DELETE /usr/local IF YOU INSTALLED THERE AND IT'S EMPTY, OTHERWISE**
+**THIS WILL DELETE /usr/local IF YOU INSTALLED THERE AND IT BECOMES EMPTY**
 
 This is not in the default behaviour of `make uninstall` for obvious reasons.
 
 
 # Other stuff #
 
-To clean up the generated manpag, run
+To clean up the generated manpage, run
 
-    make clean
+       make clean
 
 and if you are bored, I suggest
 
-    make moo
+       make moo
+
+[1]: http://rtomayko.github.io/ronn/