Synchronise installation instructions with paper supplementary material

Author: exe0cdc

documentation/source/installation.rst

@@ -2,19 +2,20 @@
 Installation
 ============
 
-PySCeSToolbox is compatible with Mac OS X, Linux, and Windows. Operating system
-specific instructions are discussed in the sections below. We have made special
-effort to provide as detailed instructions as possible, basically assuming a
+PySCeSToolbox is compatible with Mac OS X, Linux, and Windows. Operating
+system-specific instructions are discussed in the sections below. We have made
+special
+effort to provide as detailed instructions as possible, assuming a
 clean installation of each operating system prior to installation of
 PySCeSToolbox, and relatively limited knowledge of Python. If further
-assistance is required, please contact the authors.
+assistance is required, please contact the developers.
 
 Abbreviated requirements
 ------------------------
 
-PySCeSToolbox also has a number of requirements that must be met before
+PySCeSToolbox has a number of requirements that must be met before
 installation can take place. Fortunately most requirements, save for a few
-exceptions (as discussed in the operating system specific sections), will be
+exceptions (as discussed in the operating system-specific sections), will be
 taken care of automatically during installation. An abbreviated list of
 requirements follows:
 
@@ -29,7 +30,8 @@ Windows
 -------
 
 Windows requires the manual installation of **Python 2.7**,
-**PySCeS** and **Maxima**. Windows 8 and 10 were used in our tests.
+**PySCeS** and **Maxima**. Installation was tested on Windows 8 and
+10.
 
 Python
 ~~~~~~
@@ -38,7 +40,7 @@ For Windows users (especially those unfamiliar with Python) we recommend using
 the Anaconda Python distribution
 (https://www.continuum.io/downloads#windows). This is a low fuss solution
 that will install Python on you system *together with many of the packages
-necessary for running PySCeSToolbox*. Download the appropriate Python 2.7
+necessary for running PySCeSToolbox*. Download the appropriate **Python 2.7**
 package from the download page (most probably the 64bit edition) and follow the
 instructions of the installation wizard.
 
@@ -47,7 +49,7 @@ PySCeS
 After installing Anaconda, download and install the latest PySCeS binary
 package from \break http://pysces.sourceforge.net/download.html. PySCeS can also
 be built from source (for more details see the instructions given at the
-provided url).
+provided URL).
 
 Maxima
 ~~~~~~
@@ -58,7 +60,7 @@ download page at http://maxima.sourceforge.net/download.html.
 
 Windows might also require the path to ``maxima.bat`` to be defined in the
 ``psctb_config.ini`` file (found at ``C:\Pysces\psctb_config.ini`` by default).
-The default path included ``psctb_config.ini`` is set as ``C:\Program
+The default path included in ``psctb_config.ini`` is set as ``C:\Program
 Files?\Maxima?\bin\maxima.bat``, where the question marks are wildcards
 (since the specific path will depend on the version of Maxima). If Maxima has
 been installed to a user specified directory, the correct path to the
@@ -85,13 +87,13 @@ Mac OS X (MacOS)
 Mac OS X requires the manual installation of **PySCeS** and **Maxima**. While
 OS X comes pre-installed with **Python 2.7** we still recommend installing a
 Python distribution such as Anaconda as it will take care of many of the SciPy
-stack requirements. MacOS Sierra was used in our tests.
+stack requirements. Installation was tested on MacOS Sierra.
 
 Python
 ~~~~~~
 One of the most simple ways to get Python on your system is to install the
 Anaconda Python distribution (https://www.continuum.io/downloads#macos).
-Download the either of the Python 2.7 installers from the download page and
+Download either of the Python 2.7 installers from the download page and
 follow the provided instructions.
 
 PySCeS
@@ -118,8 +120,9 @@ popup (the full xcode package is *not required*. Gfortran dmg's for your
 particular version of OS X (or MacOS) can downloaded and installed from
 http://gcc.gnu.org/wiki/GFortranBinaries.
 
-Once the appropriate compilers are present this step may be skipped as PySCeS
-will be installed automatically when PySCeSToolbox is installed.
+Once the appropriate compilers are present the actual PySCeS install may be
+skipped as PySCeS will be installed automatically when PySCeSToolbox is
+installed.
 
 Maxima
 ~~~~~~
@@ -163,9 +166,9 @@ Linux
 -----
 
 Linux requires the manual installation **Maxima** and **PySCeS**.
-Most Linux systems comes pre-installed with **Python 2.7**, however a
-Python distribution such as Anaconda may be used instead. Ubuntu 16.04 was used
-in our tests.
+Most Linux systems come pre-installed with **Python 2.7**, however a
+Python distribution such as Anaconda may be used instead. Installation
+was tested on Ubuntu 16.04.
 
 Python
 ~~~~~~
@@ -186,10 +189,13 @@ with the command:
 
     pip install pysces
 
-Both cases requires the gcc, g++, and gfortran compilers to be present on the
+Both cases require the gcc, g++, and gfortran compilers to be present on the
 system. These compilers are most probably available from your OS's
-repositories. If the appropriate compilers are present this step may be skipped
-as PySCeS will be installed automatically when PySCeSToolbox is installed.
+repositories.
+
+Once the appropriate compilers are present the actual PySCeS install may be
+skipped as PySCeS will be installed automatically when PySCeSToolbox is
+installed.
 
 Maxima
 ~~~~~~