Add more detail to the install section of docs
Install
=======
-The package is hosted on `PyPI <https://pypi.org/project/lz4/>`_ and so can be
-installed via pip::
+The bindings to the LZ4 compression library provided by this package are in the
+form of a Python extension module written in C. These extension modules need to
+be compiled against the LZ4 library and the Python
+
+Installing from pre-built wheels
+--------------------------------
+
+The package is hosted on `PyPI <https://pypi.org/project/lz4/>`_ and pre-built
+wheels are available for Linux, OSX and Windows. Installation using a pre-built
+wheel can be achieved by::
$ pip install lz4
+
+Installing from source
+----------------------
+
The LZ4 bindings require linking to the LZ4 library, and so if there is not a
pre-compiled wheel available for your platform you will need to have a suitable
-C compiler available, as well as the Python development header files.
+C compiler available, as well as the Python development header files. On
+Debian/Ubuntu based systems the header files for Python are found in the
+distribution package ``pythonX.Y-dev`` e.g. ``python3.7-dev``. On Fedora/Red Hat
+based systems, the Python header files are found in the distribution package
+``python-devel``.
The LZ4 library bindings provided by this package require the LZ4 library. If
the system already has an LZ4 library and development header files present, and
@@ -16,7 +32,18 @@ the library is a recent enough version the package will build against that.
Otherwise, the package will use a bundled version of the library files to link
against. The package currently requires LZ4 version 1.7.5 or later.
-The package can also be installed manually::
+On a system for which there are no pre-built wheels available on PyPi, running
+this command will result in the extension modules being compiled from source::
+
+ $ pip install lz4
+
+On systems for which pre-built wheels are available, the following command will
+force a local compilation of the extension modules from source::
+
+ $ pip install --no-binary --no-cache-dir lz4
+
+The package can also be installed manually from a checkout of the source code
+git repository::
$ python setup.py install
