Doc updates for installation

Author: Kevin D Smith

README.rst

@@ -29,8 +29,7 @@ Requirements
 
 To access the CAS binary protocol (recommended), you need the following:
 
-1. **64-bit** Python 2.7+/3.4+ on Linux (see shared library notes below)
-2. Pandas 0.16.0+
+* **64-bit** Python 2.7, 3.4, or 3.5 on Linux (see shared library notes below)
 
 The binary protocol requires pre-compiled components found in the
 ``pip`` installer only.  These pieces are not available as source code and
@@ -40,7 +39,7 @@ amounts of data.  It also offers more advanced data loading from the client
 and data formatting features.
 
 To access the CAS REST interface only, you can use the pure Python code
-which runs in Python 2.7+/3.4+.  While not as fast as the binary protocol,
+which runs in Python 2.7/3.4+.  While not as fast as the binary protocol,
 the pure Python interface is more portable.
 
 Linux Library Dependencies
@@ -52,6 +51,14 @@ make binary protocol connections to CAS.  If you do not have this library on
 your machine you can install the ``numactl`` package for your distribution
 to make it available to SWAT.
 
+Python Dependencies
+===================
+
+The SWAT package uses many features of the Pandas Python package and other
+dependencies of Pandas.  If you do not already have version 0.16.0 or greater
+of Pandas installed, ``pip`` will install or update it for you when you
+install SWAT.
+
 
 Installation
 ------------

doc/source/install.rst

@@ -4,13 +4,10 @@
 Installation
 ============
 
-The SWAT package can be installed using either ``pip`` or just by running
-``python setup.py install`` in the expanded tar.gz file.  Before installing,
-you should make sure that you have fulfilled the following requirements.
-These requirements are for the CAS binary protocol (recommended).
+The SWAT package is installed using the ``pip`` command.  The requirements
+for using the binary protocol of CAS (recommended) are as follows.
 
-* **64-bit** Python 2.7+/3.4+ on Linux (see shared library notes below)
-* Pandas 0.16.0+
+* **64-bit** Python 2.7, 3.4, or 3.5 on Linux (see shared library notes below)
 
 The binary protocol requires pre-compiled components found in the ``pip``
 installer only.  These pieces are not available as source code and
@@ -20,7 +17,7 @@ amounts of data.  It also offers more advanced data loading from the client
 and data formatting features.
 
 To access the CAS REST interface only, you can use the pure Python code which
-runs in Python 2.7+/3.4+.  You will still need Pandas installed.  While not as
+runs in Python 2.7/3.4+.  You will still need Pandas installed.  While not as
 fast as the binary protocol, the pure Python interface is more portable.
 For more information, see :ref:`Binary vs. REST <binaryvsrest>`.
 
@@ -43,6 +40,15 @@ your machine you can install the ``numactl`` package for your distribution
 to make it available to SWAT.
 
 
+Python Dependencies
+-------------------
+
+The SWAT package uses many features of the Pandas Python package and other
+dependencies of Pandas.  If you do not already have version 0.16.0 or greater
+of Pandas installed, ``pip`` will install or update it for you when you
+install SWAT.
+
+
 Pip
 ---
 

doc/source/troubleshooting.rst

@@ -9,6 +9,26 @@ Just as with any authenticated network service, you may run into problems
 from time to time while connecting to CAS.  These are some of the more
 common problems you may run across.
 
+Missing Linux Library Dependencies
+==================================
+
+SWAT uses various shared libraries commonly available on Linux machines.
+If you are missing a shared library that SWAT requires, you may see a message
+such as the following when creating a CAS connection.
+
+.. code-block:: python
+
+   In [1]: conn = swat.CAS(hostname, port)
+   tkBoot failed:  Cannot dlopen [tkmk.so] : [libnuma.so.1: cannot open shared object file: No such file or directory]
+
+This particular error can be solved by installing the ``numactl`` package of
+your Linux distribution.  If you do not have system administrator privileges,
+you can set an environment variable ``LD_LIBRARY_PATH`` to the location of
+a copy of ``libnuma.so.1``.  However, it is recommended that you contact your system
+administrator to install this library so that it will receive regular updates
+with the system.
+
+
 Incorrect SAS TK Configuration
 ==============================