+Installation
+============
+After downloading ``shpub-x.y.z.phar``, you can either use it directly::
+
+ $ php /path/to/shpub-x.y.z.phar --version
+
+or make it more easily accessible::
+
+ $ mv /path/to/shpub-x.y.z.phar /usr/local/bin/shpub
+ $ chmod +x /usr/local/bin/shpub
+ $ shpub --version
+
+You might need ``sudo`` to be able to copy it into the ``/usr/local/bin/``
+directory.
+
+If you're running from the git checkout, start it as follows::
+
+ $ ./bin/shpub.php --version
+
+