Updated install instructions to include how to install from GitHub using pip.

1 files changed, 42 insertions, 4 deletions

diff --git a/docs/install.rst b/docs/install.rst
index 8a9d3791..83565730 100644
--- a/docs/install.rst
+++ b/docs/install.rst
@@ -14,6 +14,22 @@ install from PyPI_.
 .. _setuptools: https://pypi.python.org/pypi/setuptools
 .. _PyPI: https://pypi.python.org/pypi
 
+.. note::
+
+  Depending on how and where you have installed Python on your system and on what OS you are using, you may need to
+  have administrator or root privileges to install Python packages.  If this is the case, take the necessary steps
+  required to run the commands in this section as root/admin, e.g.: on Linux or Mac preceded them with ``sudo``::
+
+    sudo pip install <package_name>
+
+
+.. warning::
+
+  Versions of ``cmd2`` before 0.7.0 should be considered to be of unstable "beta" quality and should not be relied upon
+  for production use.  If you cannot get a version >= 0.7 from either pip or your OS repository, then we recommend
+  installing from GitHub - see :ref:`github`.
+
+
 Requirements for Installing
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 * If you have Python 2 >=2.7.9 or Python 3 >=3.4 installed from `python.org
@@ -37,13 +53,25 @@ Requirements for Installing
 Use pip for Installing
 ~~~~~~~~~~~~~~~~~~~~~~
 
-pip_ is the recommended installer. Installing with pip is easy::
+pip_ is the recommended installer. Installing packages from PyPI_ with pip is easy::
 
     pip install cmd2
 
 This should also install the required 3rd-party dependencies, if necessary.
 
 
+.. _github:
+
+Install from GitHub using pip
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The latest version of ``cmd2`` can be installed directly from the master branch on GitHub using pip_::
+
+  pip install -U git+git://github.com/python-cmd2/cmd2.git
+
+This should also install the required 3rd-party dependencies, if necessary.
+
+
 Install from Debian or Ubuntu repos
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 We recommend installing from pip_, but if you wish to install from Debian or Ubuntu repos this can be done with
@@ -62,9 +90,19 @@ This will also install the required 3rd-party dependencies.
 
 Deploy cmd2.py with your project
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-This is an option suitable for advanced Python users.  The ``cmd2`` module is a single file, **cmd2.py**.  You can
-simply include this file within your project's hierarchy.  If you want to modify ``cmd2``, this may be a reasonable
-option.  Though, we would encourage you to use stock ``cmd2`` and inheritance to achieve the same goal.
+
+``cmd2`` is contained in only one Python file (**cmd2.py**), so it can be easily copied into your project.  *The
+copyright and license notice must be retained*.
+
+This is an option suitable for advanced Python users.  You can simply include this file within your project's hierarchy.
+If you want to modify ``cmd2``, this may be a reasonable option.  Though, we encourage you to use stock ``cmd2`` and
+either composition or inheritance to achieve the same goal.
+
+This approach will obviously NOT automatically install the required 3rd-party dependencies, so you need to make sure
+the following Python packages are installed:
+
+  * six
+  * pyparsing
 
 
 Upgrading cmd2