From a38f21ee54a6dcef765c30ff33f1a367b3365bc9 Mon Sep 17 00:00:00 2001 From: Robert David Grant Date: Mon, 5 Oct 2015 14:43:42 -0500 Subject: [PATCH 01/10] Rename quickstart -> conda-quickstart and move... into its own top-level directory. Move the readme in with it. --- .travis.yml | 2 +- quickstart => quickstart/conda-quickstart | 4 ++-- {docs => quickstart}/quickstart-readme.txt | 0 3 files changed, 3 insertions(+), 3 deletions(-) rename quickstart => quickstart/conda-quickstart (98%) rename {docs => quickstart}/quickstart-readme.txt (100%) diff --git a/.travis.yml b/.travis.yml index 3d522752..da5ca16e 100644 --- a/.travis.yml +++ b/.travis.yml @@ -34,7 +34,7 @@ before_install: - conda config --set always_yes yes --set changeps1 no - conda update -q conda - conda info -a - - travis_wait $TRAVIS_BUILD_DIR/quickstart --pyversion $PYVERSION --name distarray-env --yes + - travis_wait $TRAVIS_BUILD_DIR/quickstart/conda-quickstart --pyversion $PYVERSION --name distarray-env --yes - source activate distarray-env - pip install codecov pelican - | diff --git a/quickstart b/quickstart/conda-quickstart similarity index 98% rename from quickstart rename to quickstart/conda-quickstart index dcd24513..fb4e91bf 100755 --- a/quickstart +++ b/quickstart/conda-quickstart @@ -7,7 +7,7 @@ PROMPT_USER=false TEST_INSTALL=false usage() { - echo "usage: quickstart [options] " + echo "usage: conda-quickstart [options] " echo "-------------------------------------------------------------------------" echo "OPTIONS" echo "--pyversion select which version of python to use options = (2, 3) DEFAULT 2" @@ -128,7 +128,7 @@ prompt_user() { read -n 1 } -cat docs/quickstart-readme.txt +cat quickstart/quickstart-readme.txt usage if [[ "$(uname)" == "Darwin" ]]; then diff --git a/docs/quickstart-readme.txt b/quickstart/quickstart-readme.txt similarity index 100% rename from docs/quickstart-readme.txt rename to quickstart/quickstart-readme.txt From fb248f2088aafbb227dc8f25d46422771eb8b24d Mon Sep 17 00:00:00 2001 From: Robert David Grant Date: Mon, 5 Oct 2015 14:44:21 -0500 Subject: [PATCH 02/10] Strip trailing whitespace. --- quickstart/quickstart-readme.txt | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/quickstart/quickstart-readme.txt b/quickstart/quickstart-readme.txt index a5917ad4..c2a195ac 100644 --- a/quickstart/quickstart-readme.txt +++ b/quickstart/quickstart-readme.txt @@ -1,18 +1,18 @@ -================================================================================ +================================================================================ DistArray Quickstart [OSX/Linux only] ================================================================================ -The distarray/quickstart script creates a new conda environment with a working +The distarray/quickstart script creates a new conda environment with a working copy of DistArray. Currently, quickstart is NOT supported on Microsoft Windows. -------------------------------------------------------------------------------- -------------------------------------------------------------------------------- -Depending on system hardware and the prior availability of dependencies, the -script can take anywhere from less than a minute upto a few hours to run. If the +Depending on system hardware and the prior availability of dependencies, the +script can take anywhere from less than a minute upto a few hours to run. If the installation is interrupted for any reason, delete the created conda environment [conda env remove -n ] and re-run the script. Prerequisites for using DistArray quickstart are: - A working conda installation (Anaconda/Miniconda) - + Additionally, OSX users will need: - A working MPI distribution that provides the 'mpicc' compiler wrapper OR @@ -20,7 +20,7 @@ Additionally, OSX users will need: need 'sudo' privileges) Notes - - OSX: Using quickstart with MacPorts/HomeBrew will build DistArray + - OSX: Using quickstart with MacPorts/HomeBrew will build DistArray using the Open-MPI implementation - Linux: Using quickstart will build DistArray using mpi4py binaries from conda From 38812f520ff1c97040438d5106bdaa5fde735ecd Mon Sep 17 00:00:00 2001 From: Robert David Grant Date: Mon, 5 Oct 2015 14:55:15 -0500 Subject: [PATCH 03/10] Make the README a more standard .rst file... like the other docs files in DistArray. --- quickstart/{quickstart-readme.txt => README.rst} | 0 quickstart/conda-quickstart | 2 +- 2 files changed, 1 insertion(+), 1 deletion(-) rename quickstart/{quickstart-readme.txt => README.rst} (100%) diff --git a/quickstart/quickstart-readme.txt b/quickstart/README.rst similarity index 100% rename from quickstart/quickstart-readme.txt rename to quickstart/README.rst diff --git a/quickstart/conda-quickstart b/quickstart/conda-quickstart index fb4e91bf..9a7b308d 100755 --- a/quickstart/conda-quickstart +++ b/quickstart/conda-quickstart @@ -128,7 +128,7 @@ prompt_user() { read -n 1 } -cat quickstart/quickstart-readme.txt +cat quickstart/README.rst usage if [[ "$(uname)" == "Darwin" ]]; then From e16fea07f04eb15f6c7d40c62998afd797111414 Mon Sep 17 00:00:00 2001 From: Robert David Grant Date: Mon, 5 Oct 2015 17:38:10 -0500 Subject: [PATCH 04/10] Update the README.rst for the quickstart. --- quickstart/README.rst | 38 +++++++++++++++++++++----------------- 1 file changed, 21 insertions(+), 17 deletions(-) diff --git a/quickstart/README.rst b/quickstart/README.rst index c2a195ac..222087af 100644 --- a/quickstart/README.rst +++ b/quickstart/README.rst @@ -1,27 +1,31 @@ -================================================================================ - DistArray Quickstart [OSX/Linux only] -================================================================================ -The distarray/quickstart script creates a new conda environment with a working -copy of DistArray. Currently, quickstart is NOT supported on Microsoft Windows. --------------------------------------------------------------------------------- --------------------------------------------------------------------------------- +DistArray Quickstart +==================== + +[OSX/Linux only] + +The conda-quickstart script creates a new conda environment with a working copy +of DistArray. Currently, neither conda-quickstart (nor DistArray) are +supported on Microsoft Windows. + Depending on system hardware and the prior availability of dependencies, the -script can take anywhere from less than a minute upto a few hours to run. If the +script can take anywhere from less than a minute up to a few hours to run. If the installation is interrupted for any reason, delete the created conda environment -[conda env remove -n ] and re-run the script. +(``conda env remove -n ``) and re-run the script. + +Prerequisites for using conda-quickstart are: -Prerequisites for using DistArray quickstart are: - A working conda installation (Anaconda/Miniconda) Additionally, OSX users will need: -- A working MPI distribution that provides the 'mpicc' compiler wrapper - OR + +- A working MPI distribution that provides the ``mpicc`` compiler wrapper, *OR* - A working copy of HomeBrew or MacPorts to install MPI (MacPorts users will need 'sudo' privileges) Notes - - OSX: Using quickstart with MacPorts/HomeBrew will build DistArray - using the Open-MPI implementation - - Linux: Using quickstart will build DistArray using mpi4py binaries - from conda --------------------------------------------------------------------------------- +----- + +- OSX: Using conda-quickstart will install Open-MPI with MacPorts or Homebrew and + mpi4py using pip. +- Linux: Using conda-quickstart will install MPI and mpi4py with conda + (installs MPICH2 at the time of writing). From 52da8448c47c990a18a233e22e12a97b33e710d4 Mon Sep 17 00:00:00 2001 From: Robert David Grant Date: Mon, 5 Oct 2015 17:43:26 -0500 Subject: [PATCH 05/10] Small tweaks to README. --- quickstart/README.rst | 26 ++++++++++++-------------- 1 file changed, 12 insertions(+), 14 deletions(-) diff --git a/quickstart/README.rst b/quickstart/README.rst index 222087af..6576f6bf 100644 --- a/quickstart/README.rst +++ b/quickstart/README.rst @@ -1,20 +1,18 @@ -DistArray Quickstart -==================== +conda-quickstart +================ -[OSX/Linux only] - -The conda-quickstart script creates a new conda environment with a working copy -of DistArray. Currently, neither conda-quickstart (nor DistArray) are -supported on Microsoft Windows. +The ``conda-quickstart`` script creates a new conda environment that includes +DistArray and its dependencies. Currently, neither conda-quickstart (nor +DistArray) are supported on Microsoft Windows. Depending on system hardware and the prior availability of dependencies, the -script can take anywhere from less than a minute up to a few hours to run. If the -installation is interrupted for any reason, delete the created conda environment -(``conda env remove -n ``) and re-run the script. +script can take anywhere from less than a minute up to a few hours to run. If +the installation is interrupted for any reason, delete the created conda +environment (``conda env remove -n ``) and re-run the script. Prerequisites for using conda-quickstart are: -- A working conda installation (Anaconda/Miniconda) +- A working Anaconda or Miniconda installation Additionally, OSX users will need: @@ -25,7 +23,7 @@ Additionally, OSX users will need: Notes ----- -- OSX: Using conda-quickstart will install Open-MPI with MacPorts or Homebrew and - mpi4py using pip. -- Linux: Using conda-quickstart will install MPI and mpi4py with conda +- On OSX: ``conda-quickstart`` will install Open-MPI with MacPorts or Homebrew and + will install mpi4py using pip. +- On Linux: ``conda-quickstart`` will install MPI and mpi4py with conda (installs MPICH2 at the time of writing). From 2a95e90a14cf5d9fc0683038506b49bcc45539af Mon Sep 17 00:00:00 2001 From: Robert David Grant Date: Wed, 7 Oct 2015 17:41:07 -0500 Subject: [PATCH 06/10] Update conda-quickstart. In the script, I remove the "--test" option, since distarray.run_test currently only works with a "--develop" installation. I've created a GitHub issue for this. --- quickstart/conda-quickstart | 72 ++++++++++++++++++------------------- 1 file changed, 34 insertions(+), 38 deletions(-) diff --git a/quickstart/conda-quickstart b/quickstart/conda-quickstart index 9a7b308d..3c94db42 100755 --- a/quickstart/conda-quickstart +++ b/quickstart/conda-quickstart @@ -1,45 +1,41 @@ #!/usr/bin/env bash +INSTALL_MODE=install +PROMPT_USER=true + PY_VER=2 CONDA_ENV=distarray -INSTALL_MODE=install -PROMPT_USER=false -TEST_INSTALL=false usage() { echo "usage: conda-quickstart [options] " echo "-------------------------------------------------------------------------" echo "OPTIONS" - echo "--pyversion select which version of python to use options = (2, 3) DEFAULT 2" echo "-h | --help display usage message" + echo "--pyversion select which version of python to use options = (2, 3) DEFAULT 2" echo "-n | --name set name of created conda environment to DEFAULT distarray" echo "-d | --develop perform a development install of distarray" echo "-y | --yes do not ask for confirmation" - echo "-t | --test test distarray after installation" } while [[ "$1" != "" ]]; do case $1 in - -n | --name ) - shift - CONDA_ENV=$1 - ;; - -d | --develop ) - INSTALL_MODE=develop - ;; -h | --help ) usage exit ;; - -y | --yes ) - PROMPT_USER=true - ;; --pyversion ) shift PY_VER=$1 ;; - -t | --test ) - TEST_INSTALL=true + -n | --name ) + shift + CONDA_ENV=$1 + ;; + -d | --develop ) + INSTALL_MODE=develop + ;; + -y | --yes ) + PROMPT_USER=false ;; * ) usage @@ -57,8 +53,8 @@ install_openmpi() { brew install openmpi return 0 else - echo "Could not install OpenMPI: no working installation of homebrew or macports found." - return 1 + echo "Could not install OpenMPI: no working installation of homebrew" + echo "or macports found." fi } @@ -90,9 +86,10 @@ resolve_conda() { install_osx() { conda create -n $CONDA_ENV python=$PY_VER numpy ipyparallel notebook cython sphinx=1.3 mock matplotlib source activate $CONDA_ENV - pip install mpi4py - pip install sphinxcontrib-programoutput + pip install mpi4py sphinxcontrib-programoutput + pushd .. python setup.py $INSTALL_MODE + popd source deactivate return 0 } @@ -101,14 +98,17 @@ install_linux() { conda create -n $CONDA_ENV python=$PY_VER mpi4py numpy ipyparallel notebook cython sphinx=1.3 mock matplotlib source activate $CONDA_ENV pip install sphinxcontrib-programoutput + pushd .. python setup.py $INSTALL_MODE + popd source deactivate return 0 } exit_install() { if [[ $1 != 0 ]]; then - echo "Aborting DistArray quickstart install. Please refer to the quickstart instructions for troubleshooting" + echo "Aborting DistArray quickstart install. Please refer to the" + echo "quickstart instructions for troubleshooting." exit 1 else return 0 @@ -124,11 +124,13 @@ test_install() { } prompt_user() { - echo "Press any key to continue installation with the provided options. Ctrl+C to abort." + echo "Press any key to continue installation with the provided options." + echo "Ctrl+C to abort." read -n 1 } -cat quickstart/README.rst +cat conda-readme.rst +echo usage if [[ "$(uname)" == "Darwin" ]]; then @@ -150,7 +152,6 @@ if [[ "$(uname)" == "Darwin" ]]; then exit_install $r_stat else - echo "Linux support for DistArray quickstart is experimental and may not produce desired results." if [ "$PROMPT_USER" = true ] ; then prompt_user fi @@ -164,16 +165,11 @@ else exit_install $r_stat fi -if [ "$TEST_INSTALL" = true ] ; then - echo "Install Complete. Testing DistArray" - echo "--------------------------------------------------------------------------------------" - test_install - echo "--------------------------------------------------------------------------------------------" - echo "Installation complete. Use source activate $CONDA_ENV to begin working with DistArray." - echo "--------------------------------------------------------------------------------------------" -else - echo "--------------------------------------------------------------------------------------------" - echo "Installation complete. Use source activate $CONDA_ENV to begin working with DistArray." - echo "Test your installation by running dacluster start followed by python -m distarray.run_tests." - echo "--------------------------------------------------------------------------------------------" -fi +echo "-------------------------------------------------------------------------------" +echo "Installation complete. Use source activate $CONDA_ENV to begin working." +echo "with DistArray." +echo +echo 'If you performed a development installation (with --develop), you can' +echo 'test DistArray by running "dacluster start" followed by' +echo '"python -m distarray.run_tests".' +echo "-------------------------------------------------------------------------------" From b21ac7bf80f126bea662dff21613051190fd36c9 Mon Sep 17 00:00:00 2001 From: Robert David Grant Date: Wed, 7 Oct 2015 17:41:32 -0500 Subject: [PATCH 07/10] Rename and expand the conda quickstart readme. --- quickstart/README.rst | 29 -------------------- quickstart/conda-readme.rst | 53 +++++++++++++++++++++++++++++++++++++ 2 files changed, 53 insertions(+), 29 deletions(-) delete mode 100644 quickstart/README.rst create mode 100644 quickstart/conda-readme.rst diff --git a/quickstart/README.rst b/quickstart/README.rst deleted file mode 100644 index 6576f6bf..00000000 --- a/quickstart/README.rst +++ /dev/null @@ -1,29 +0,0 @@ -conda-quickstart -================ - -The ``conda-quickstart`` script creates a new conda environment that includes -DistArray and its dependencies. Currently, neither conda-quickstart (nor -DistArray) are supported on Microsoft Windows. - -Depending on system hardware and the prior availability of dependencies, the -script can take anywhere from less than a minute up to a few hours to run. If -the installation is interrupted for any reason, delete the created conda -environment (``conda env remove -n ``) and re-run the script. - -Prerequisites for using conda-quickstart are: - -- A working Anaconda or Miniconda installation - -Additionally, OSX users will need: - -- A working MPI distribution that provides the ``mpicc`` compiler wrapper, *OR* -- A working copy of HomeBrew or MacPorts to install MPI (MacPorts users will - need 'sudo' privileges) - -Notes ------ - -- On OSX: ``conda-quickstart`` will install Open-MPI with MacPorts or Homebrew and - will install mpi4py using pip. -- On Linux: ``conda-quickstart`` will install MPI and mpi4py with conda - (installs MPICH2 at the time of writing). diff --git a/quickstart/conda-readme.rst b/quickstart/conda-readme.rst new file mode 100644 index 00000000..6632e0e4 --- /dev/null +++ b/quickstart/conda-readme.rst @@ -0,0 +1,53 @@ +conda-quickstart +================ + +[OS X or Linux] + +Note: this script is currently experimental. + +The ``conda-quickstart`` script attempts to create a new conda environment that +includes DistArray, its dependencies, and the dependencies required to build +the DistArray docs. + +This script does *not* attempt to install parallel versions of hdf5 or h5py, +which are optional dependencies. + +``conda-quickstart`` is intended to be run from within this directory + +Depending on system hardware and the prior availability of dependencies, the +script can take anywhere from less than a minute up to a few hours to run. If +the installation is interrupted for any reason, delete the created conda +environment (``conda env remove -n ``) and re-run the script. + +Prerequisites +------------- + +Prerequisites for using ``conda-quickstart`` are: + +- A working Anaconda or Miniconda installation + +Additionally, OSX users will need: + +- A working MPI distribution that provides the ``mpicc`` compiler wrapper, *OR* + a working copy of HomeBrew or MacPorts to install MPI (MacPorts users will + need 'sudo' privileges) + +Notes on OS X +------------- + +On OSX, ``conda-quickstart`` will install + +- Open MPI with MacPorts or Homebrew, if ``mpicc`` isn't found, +- several Python dependencies using ``conda``, and finally +- a couple of Python dependencies (those not installable with enpkg) through + ``pip``. + +Notes on Linux +-------------- + +On Linux, ``conda-quickstart`` will install + +- Several Python dependencies using ``conda`` (including MPICH2 and mpi4py), + and +- a couple of Python dependencies (those not installable with enpkg) through + ``pip``. From 3f9f0174c3626ed9a00e4f0220512a56f8e9cfc6 Mon Sep 17 00:00:00 2001 From: Robert David Grant Date: Wed, 7 Oct 2015 17:41:44 -0500 Subject: [PATCH 08/10] Add an enpkg-quickstart script and readme. --- quickstart/enpkg-quickstart | 142 ++++++++++++++++++++++++++++++++++++ quickstart/enpkg-readme.rst | 40 ++++++++++ 2 files changed, 182 insertions(+) create mode 100755 quickstart/enpkg-quickstart create mode 100644 quickstart/enpkg-readme.rst diff --git a/quickstart/enpkg-quickstart b/quickstart/enpkg-quickstart new file mode 100755 index 00000000..b1bcb021 --- /dev/null +++ b/quickstart/enpkg-quickstart @@ -0,0 +1,142 @@ +#!/usr/bin/env bash + +INSTALL_MODE=install +PROMPT_USER=true + +usage() { + echo "usage: enpkg-quickstart [options] " + echo "-------------------------------------------------------------------------" + echo "OPTIONS" + echo "-h | --help display usage message" + echo "-d | --develop perform a development install of distarray" + echo "-y | --yes do not ask for confirmation" +} + +while [[ "$1" != "" ]]; do + case $1 in + -h | --help ) + usage + exit + ;; + -d | --develop ) + INSTALL_MODE=develop + ;; + -y | --yes ) + PROMPT_USER=false + ;; + * ) + usage + exit 1 + esac + shift +done + +install_openmpi() { + if command -v port >/dev/null 2>&1 ; then + sudo port install openmpi + sudo port select --set mpi openmpi-mp-fortran + return 0 + elif command -v brew >/dev/null 2>&1 ; then + brew install openmpi + return 0 + else + echo "Could not install OpenMPI: no working installation of homebrew" + echo "or macports found." + return 1 + fi +} + +resolve_mpicc() { + if command -v mpicc >/dev/null 2>&1 ; then + echo "Working MPI installation found at `which mpicc`." + return 0 + else + install_openmpi + r_stat=$? + if [[ $r_stat != 0 ]]; then + return 1 + else + return 0 + fi + fi +} + +resolve_enpkg() { + if command -v enpkg >/dev/null 2>&1 ; then + echo "Working enpkg installation found at `which enpkg`." + return 0 + else + echo "No working installation of Canopy or EPD found." + return 1 + fi +} + +install_osx() { + enpkg numpy notebook cython sphinx mock matplotlib + pip install ipyparallel mpi4py sphinxcontrib-programoutput + pushd .. + python setup.py $INSTALL_MODE + popd + return 0 +} + +install_linux() { + enpkg numpy notebook cython sphinx mock matplotlib + pip install ipyparallel mpi4py sphinxcontrib-programoutput + pushd .. + python setup.py $INSTALL_MODE + popd + return 0 +} + +exit_install() { + if [[ $1 != 0 ]]; then + echo "Aborting DistArray quickstart install. Please refer to the" + echo "quickstart instructions for troubleshooting." + exit 1 + else + return 0 + fi +} + +prompt_user() { + echo "Press any key to continue installation with the provided options." + echo "Ctrl+C to abort." + read -n 1 +} + +cat enpkg-readme.rst +echo +usage + + +if [ "$PROMPT_USER" = true ] ; then + prompt_user +fi + +resolve_mpicc +r_stat=$? +exit_install $r_stat + +resolve_enpkg +r_stat=$? +exit_install $r_stat + +if [[ "$(uname)" == "Darwin" ]]; then + install_osx + r_stat=$? + exit_install $r_stat +else + install_linux + r_stat=$? + exit_install $r_stat +fi + + +echo '-------------------------------------------------------------------------------' +echo 'Installation complete.' +echo +echo 'If you performed a development installation (with --develop), you can' +echo 'test DistArray by running "dacluster start" followed by' +echo '"python -m distarray.run_tests".' +echo '-------------------------------------------------------------------------------' diff --git a/quickstart/enpkg-readme.rst b/quickstart/enpkg-readme.rst new file mode 100644 index 00000000..48b1252c --- /dev/null +++ b/quickstart/enpkg-readme.rst @@ -0,0 +1,40 @@ +enpkg-quickstart +================ + +[OS X only] + +Note: this script is currently experimental. + +The ``enpkg-quickstart`` script attempts to install DistArray, its +dependencies, and the dependencies needed to build the DistArray docs. This +script is intended to work with your Enthought Canopy installation. + +This script does *not* attempt to install parallel versions of hdf5 or h5py, +which are optional dependencies. + +``enpkg-quickstart`` is intended to be run from within this directory. + +Depending on your system hardware and the prior availability of dependencies, +the script can take anywhere from less than a minute up to a few hours to run. + +Prerequisites +------------- + +Prerequisites for using ``enpkg-quickstart`` are: + +- A working Canopy or EPD installation, and + +- A working MPI distribution that provides the ``mpicc`` compiler wrapper, *OR* + a working copy of HomeBrew or MacPorts to install MPI (MacPorts users will + need 'sudo' privileges) + + +Notes +----- + +``enpkg-quickstart`` will install + +- Open MPI with MacPorts or Homebrew, if ``mpicc`` isn't found, +- several Python dependencies using ``enpkg``, and finally +- a couple of Python dependencies (those not installable with enpkg) through + ``pip``. From feb531d54841377b4feef5ab8ad7bbf0e7fb7837 Mon Sep 17 00:00:00 2001 From: Robert David Grant Date: Wed, 7 Oct 2015 18:12:21 -0500 Subject: [PATCH 09/10] Update installation doc. --- docs/sphinx/source/installation.rst | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/docs/sphinx/source/installation.rst b/docs/sphinx/source/installation.rst index a3b03bd4..a87b9de5 100644 --- a/docs/sphinx/source/installation.rst +++ b/docs/sphinx/source/installation.rst @@ -28,14 +28,14 @@ or:: pip install distarray -Experimental conda-quickstart ------------------------------ +Experimental quickstart scripts +------------------------------- -Alternatively, we have an experimental `conda-quickstart` script in the -``quickstart`` directory of the root of this source tree. Given an Anaconda -installation, this script will attempt to install create a conda environment -for you, installing MPI, mpi4py, and the above Python dependencies as -necessary. See ``README.rst`` in that directory for more information. +Alternatively, we have experimental installation scripts in the ``quickstart`` +directory of the root of this source tree. Given a Canopy or Anaconda +installation and a couple of other prerequisites, these scripts attempt to +install DistArray and its dependencies for you. See the readme files in that +directory for more information. Testing Your Installation @@ -56,6 +56,7 @@ directory with:: make test -or from anywhere with:: +If you've installed DistArray with ``python setup.py develop``, you should be +able to run the tests from anywhere with:: python -m distarray.run_tests From ec9f783dbedb3db56d2f8f9f86152fb71b638405 Mon Sep 17 00:00:00 2001 From: Robert David Grant Date: Thu, 15 Oct 2015 16:12:05 -0500 Subject: [PATCH 10/10] Tweak the READMEs. --- quickstart/conda-readme.rst | 14 +++++++------- quickstart/enpkg-readme.rst | 11 ++++++----- 2 files changed, 13 insertions(+), 12 deletions(-) diff --git a/quickstart/conda-readme.rst b/quickstart/conda-readme.rst index 6632e0e4..a36d0c92 100644 --- a/quickstart/conda-readme.rst +++ b/quickstart/conda-readme.rst @@ -3,7 +3,7 @@ conda-quickstart [OS X or Linux] -Note: this script is currently experimental. +Note: this script is currently *experimental*. The ``conda-quickstart`` script attempts to create a new conda environment that includes DistArray, its dependencies, and the dependencies required to build @@ -28,8 +28,8 @@ Prerequisites for using ``conda-quickstart`` are: Additionally, OSX users will need: -- A working MPI distribution that provides the ``mpicc`` compiler wrapper, *OR* - a working copy of HomeBrew or MacPorts to install MPI (MacPorts users will +- A working MPI distribution that provides the ``mpicc`` compiler wrapper +- *OR* a working copy of HomeBrew or MacPorts to install MPI (MacPorts users will need 'sudo' privileges) Notes on OS X @@ -39,8 +39,8 @@ On OSX, ``conda-quickstart`` will install - Open MPI with MacPorts or Homebrew, if ``mpicc`` isn't found, - several Python dependencies using ``conda``, and finally -- a couple of Python dependencies (those not installable with enpkg) through - ``pip``. +- a couple of Python dependencies (those not installable with ``conda``) + through ``pip``. Notes on Linux -------------- @@ -49,5 +49,5 @@ On Linux, ``conda-quickstart`` will install - Several Python dependencies using ``conda`` (including MPICH2 and mpi4py), and -- a couple of Python dependencies (those not installable with enpkg) through - ``pip``. +- a couple of Python dependencies (those not installable with ``conda``) + through ``pip``. diff --git a/quickstart/enpkg-readme.rst b/quickstart/enpkg-readme.rst index 48b1252c..a9da7b93 100644 --- a/quickstart/enpkg-readme.rst +++ b/quickstart/enpkg-readme.rst @@ -3,11 +3,12 @@ enpkg-quickstart [OS X only] -Note: this script is currently experimental. +Note: this script is currently *experimental*. The ``enpkg-quickstart`` script attempts to install DistArray, its dependencies, and the dependencies needed to build the DistArray docs. This -script is intended to work with your Enthought Canopy installation. +script is intended to work with your Enthought Canopy installation. This +script may update existing packages. This script does *not* attempt to install parallel versions of hdf5 or h5py, which are optional dependencies. @@ -24,9 +25,9 @@ Prerequisites for using ``enpkg-quickstart`` are: - A working Canopy or EPD installation, and -- A working MPI distribution that provides the ``mpicc`` compiler wrapper, *OR* - a working copy of HomeBrew or MacPorts to install MPI (MacPorts users will - need 'sudo' privileges) +- A working MPI distribution that provides the ``mpicc`` compiler wrapper +- *OR* a working copy of HomeBrew or MacPorts to install MPI (MacPorts users + will need 'sudo' privileges) Notes