summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorTodd Gamblin <tgamblin@llnl.gov>2015-02-24 10:26:26 -0800
committerTodd Gamblin <tgamblin@llnl.gov>2015-02-24 10:26:26 -0800
commit5eb7e466545ffc2e954a283074ec661bca87afa3 (patch)
tree98243275748a879345bc90fbf74ba0d96bb7d2ac /lib
parent447e2959476b84b317dbc5acba623a66968aa7c4 (diff)
downloadspack-5eb7e466545ffc2e954a283074ec661bca87afa3.tar.gz
spack-5eb7e466545ffc2e954a283074ec661bca87afa3.tar.bz2
spack-5eb7e466545ffc2e954a283074ec661bca87afa3.tar.xz
spack-5eb7e466545ffc2e954a283074ec661bca87afa3.zip
Spell check docs
Diffstat (limited to 'lib')
-rw-r--r--lib/spack/docs/basic_usage.rst22
-rw-r--r--lib/spack/docs/developer_guide.rst10
-rw-r--r--lib/spack/docs/mirrors.rst4
-rw-r--r--lib/spack/docs/packaging_guide.rst52
-rw-r--r--lib/spack/docs/site_configuration.rst8
5 files changed, 48 insertions, 48 deletions
diff --git a/lib/spack/docs/basic_usage.rst b/lib/spack/docs/basic_usage.rst
index 3d808708e1..ed79790bb9 100644
--- a/lib/spack/docs/basic_usage.rst
+++ b/lib/spack/docs/basic_usage.rst
@@ -13,7 +13,7 @@ Listing available packages
The first thing you likely want to do with spack is to install some
software. Before that, you need to know what's available. You can
-see avaialble package names either using the :ref:`package-list`, or
+see available package names either using the :ref:`package-list`, or
using the commands below.
.. _spack-list:
@@ -27,7 +27,7 @@ Spack can install:
.. command-output:: spack list
The packages are listed by name in alphabetical order. You can also
-do wildcard searches using ``*``:
+do wildcats searches using ``*``:
.. command-output:: spack list m*
@@ -64,14 +64,14 @@ There are two sections in the output. *Safe versions* are ones that
have already been checksummed. Spack goes a step further, though, and
also shows you what versions are available out on the web---these are
*remote versions*. Spack gets this information by scraping it
-directly from webpages. Depending on the package, Spack may or may
+directly from web pages. Depending on the package, Spack may or may
not be able to find any remote versions.
Installing and uninstalling
------------------------------
-Now that you know how to list avaiable packages and versions, you're
+Now that you know how to list available packages and versions, you're
ready to start installing things.
.. _spack-install:
@@ -80,7 +80,7 @@ ready to start installing things.
~~~~~~~~~~~~~~~~~~~~~
``spack install`` will install any package shown by ``spack list``.
-To install the latest version of a pacakge, along with all of its
+To install the latest version of a package, along with all of its
dependencies, simply give it a package name:
.. code-block:: sh
@@ -227,7 +227,7 @@ Packages are divided into groups according to their architecture and
compiler. Within each group, Spack tries to keep the view simple, and
only shows the version of installed packages.
-In some cases, there may be differnt configurations of the *same*
+In some cases, there may be different configurations of the *same*
version of a package installed. For example, there are two
installations of of ``libdwarf@20130729`` above. We can look at them
in more detail using ``spack find -d``, and by asking only to show
@@ -362,7 +362,7 @@ where the compiler is installed. For example::
intel@13.0.079
Or you can run ``spack compiler add`` with no arguments to force
-autodetection. This is useful if you do not know where compilers are
+auto-detection. This is useful if you do not know where compilers are
installed, but you know that new compilers have been added to your
``PATH``. For example, using dotkit, you might do this::
@@ -398,7 +398,7 @@ matching Intel compiler was displayed.
Manual compiler configuration
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-If autodetection fails, you can manually conigure a compiler by
+If auto-detection fails, you can manually configure a compiler by
editing your ``~/.spackconfig`` file. You can do this by running
``spack config edit``, which will open the file in your ``$EDITOR``.
@@ -1021,7 +1021,7 @@ You can find extensions for your Python installation like this:
==> None activated.
The extensions are a subset of what's returned by ``spack list``, and
-they are packages like any ohter. They are installed into their own
+they are packages like any other. They are installed into their own
prefixes, and you can see this with ``spack find -p``:
.. code-block:: sh
@@ -1098,7 +1098,7 @@ Several things have happened here. The user requested that
``py-numpy`` be activated in the ``python`` installation it was built
with. Spack knows that ``py-numpy`` depends on ``py-nose`` and
``py-setuptools``, so it activated those packages first. Finally,
-once all dpeendencies were activated in the ``python`` installation,
+once all dependencies were activated in the ``python`` installation,
``py-numpy`` was activated as well.
If we run ``spack extensions`` again, we now see the three new
@@ -1130,7 +1130,7 @@ packages listed as activated:
py-nose@1.3.4 py-numpy@1.9.1 py-setuptools@11.3.1
-Now, when a user runs python, ``numpy`` will be avaiable for import
+Now, when a user runs python, ``numpy`` will be available for import
*without* the user having to explicitly loaded. ``python@2.7.8`` now
acts like a system Python installation with ``numpy`` installed inside
of it.
diff --git a/lib/spack/docs/developer_guide.rst b/lib/spack/docs/developer_guide.rst
index 969ed60b15..db47de80f5 100644
--- a/lib/spack/docs/developer_guide.rst
+++ b/lib/spack/docs/developer_guide.rst
@@ -50,11 +50,11 @@ as a descriptor for one or more instances of that template. Users
express the configuration they want using a spec, and a package turns
the spec into a complete build.
-The obvious difficulty with this design is that users underspecify
+The obvious difficulty with this design is that users under-specify
what they want. To build a software package, the package object needs
a *complete* specification. In Spack, if a spec describes only one
instance of a package, then we say it is **concrete**. If a spec
-could describes many instances, (i.e. it is underspecified in one way
+could describes many instances, (i.e. it is under-specified in one way
or another), then we say it is **abstract**.
Spack's job is to take an *abstract* spec from the user, find a
@@ -92,7 +92,7 @@ with a high level view of Spack's directory structure::
Spack is designed so that it could live within a `standard UNIX
directory hierarchy <http://linux.die.net/man/7/hier>`_, so ``lib``,
``var``, and ``opt`` all contain a ``spack`` subdirectory in case
-Spack is installed alongside other software. Most of the insteresting
+Spack is installed alongside other software. Most of the interesting
parts of Spack live in ``lib/spack``. Files under ``var`` are created
as needed, so there is no ``var`` directory when you initially clone
Spack from the repository.
@@ -123,13 +123,13 @@ Package-related modules
Contains the :class:`Package <spack.package.Package>` class, which
is the superclass for all packages in Spack. Methods on ``Package``
implement all phases of the :ref:`package lifecycle
- <pacakge-lifecycle>` and manage the build process.
+ <package-lifecycle>` and manage the build process.
:mod:`spack.packages`
Contains all of the packages in Spack and methods for managing them.
Functions like :func:`packages.get <spack.packages.get>` and
:func:`class_name_for_package_name
- <packages.class_name_for_package_name>` handle mapping packge module
+ <packages.class_name_for_package_name>` handle mapping package module
names to class names and dynamically instantiating packages by name
from module files.
diff --git a/lib/spack/docs/mirrors.rst b/lib/spack/docs/mirrors.rst
index 57ca1af068..d732a3dd54 100644
--- a/lib/spack/docs/mirrors.rst
+++ b/lib/spack/docs/mirrors.rst
@@ -47,7 +47,7 @@ contains tarballs for each package, named after each package.
In order to make mirror creation reasonably fast, we copy the
tarball in its original format to the mirror directory, but we do
not standardize on a particular compression algorithm, because this
- would potentially require expanding and recompressing each archive.
+ would potentially require expanding and re-compressing each archive.
.. _spack-mirror:
@@ -161,7 +161,7 @@ your site.
``spack mirror add``
----------------------------
-Once you have a mirrror, you need to let spack know about it. This is
+Once you have a mirror, you need to let spack know about it. This is
relatively simple. First, figure out the URL for the mirror. If it's
a file, you can use a file URL like this one::
diff --git a/lib/spack/docs/packaging_guide.rst b/lib/spack/docs/packaging_guide.rst
index 8b4c0a4ce1..59ba63fa35 100644
--- a/lib/spack/docs/packaging_guide.rst
+++ b/lib/spack/docs/packaging_guide.rst
@@ -5,7 +5,7 @@ Packaging Guide
This guide is intended for developers or administrators who want to
package software so that Spack can install it. It assumes that you
-have at least some familiarty with Python, and that you've read the
+have at least some familiarity with Python, and that you've read the
:ref:`basic usage guide <basic-usage>`, especially the part about
:ref:`specs <sec-specs>`.
@@ -459,7 +459,7 @@ example for ``libelf``:
How many would you like to checksum? (default is 5, q to abort)
This does the same thing that ``spack create`` does, but it allows you
-to go back and add new vesrions easily as you need them (e.g., as
+to go back and add new versions easily as you need them (e.g., as
they're released). It fetches the tarballs you ask for and prints out
a list of ``version`` commands ready to copy/paste into your package
file:
@@ -479,7 +479,7 @@ in ``http://example.com/downloads/`` for links to additional versions.
If you need to search another path for download links, you can supply
some extra attributes that control how your package finds new
versions. See the documentation on `attribute_list_url`_ and
-`attributee_list_depth`_.
+`attribute_list_depth`_.
.. note::
@@ -490,7 +490,7 @@ versions. See the documentation on `attribute_list_url`_ and
manually add ``version`` calls yourself.
* For ``spack checksum`` to work, Spack needs to be able to
- ``import`` your pacakge in Python. That means it can't have any
+ ``import`` your package in Python. That means it can't have any
syntax errors, or the ``import`` will fail. Use this once you've
got your package in working order.
@@ -643,7 +643,7 @@ Revisions
revisions, you can use ``revision`` for branches, tags, and commits
when you fetch with Mercurial.
-As wtih git, you can fetch these versions using the ``spack install
+As with git, you can fetch these versions using the ``spack install
example@<version>`` command-line syntax.
.. _svn-fetch:
@@ -927,7 +927,7 @@ the ``list_url``, because that is where links to old versions are:
~~~~~~~~~~~~~~~~~~~~~
``libdwarf`` and many other packages have a listing of available
-verisons on a single webpage, but not all do. For example, ``mpich``
+versions on a single webpage, but not all do. For example, ``mpich``
has a tarball URL that looks like this:
url = "http://www.mpich.org/static/downloads/3.0.4/mpich-3.0.4.tar.gz"
@@ -1095,7 +1095,7 @@ called before the ``install()`` method of any dependent packages.
This allows dependencies to set up environment variables and other
properties to be used by dependents.
-The funciton declaration should look like this:
+The function declaration should look like this:
.. code-block:: python
@@ -1115,7 +1115,7 @@ The arguments to this function are:
* **spec**: the spec of the *dependency package* (the one the function is called on).
* **dep_spec**: the spec of the dependent package (i.e. dep_spec depends on spec).
-A goo example of using these is in the Python packge:
+A good example of using these is in the Python package:
.. code-block:: python
@@ -1148,7 +1148,7 @@ packages to have a very simple install method, like this:
def install(self, spec, prefix):
python('setup.py', 'install', '--prefix=%s' % prefix)
-Python's ``setup_dependent_environment`` method also sets up smoe
+Python's ``setup_dependent_environment`` method also sets up some
other variables, creates a directory, and sets up the ``PYTHONPATH``
so that dependent packages can find their dependencies at build time.
@@ -1217,7 +1217,7 @@ Activation & deactivation
Spack's ``Package`` class has default ``activate`` and ``deactivate``
implementations that handle symbolically linking extensions' prefixes
into the directory of the parent package. However, extendable
-packages can override these methdos to add custom activate/deactivate
+packages can override these methods to add custom activate/deactivate
logic of their own. For example, the ``activate`` and ``deactivate``
methods in the Python class use the symbolic linking, but they also
handle details surrounding Python's ``.pth`` files, and other aspects
@@ -1286,7 +1286,7 @@ Virtual dependencies
-----------------------------
In some cases, more than one package can satisfy another package's
-dependency. One way this can happen is if a pacakge depends on a
+dependency. One way this can happen is if a package depends on a
particular *interface*, but there are multiple *implementations* of
the interface, and the package could be built with any of them. A
*very* common interface in HPC is the `Message Passing Interface (MPI)
@@ -1299,7 +1299,7 @@ MPI has several different implementations (e.g., `MPICH
applications can be built with any one of them. Complicating matters,
MPI does not have a standardized ABI, so a package built with one
implementation cannot simply be relinked with another implementation.
-Many pacakage managers handle interfaces like this by requiring many
+Many package managers handle interfaces like this by requiring many
similar package files, e.g., ``foo``, ``foo-mvapich``, ``foo-mpich``,
but Spack avoids this explosion of package files by providing support
for *virtual dependencies*.
@@ -1325,7 +1325,7 @@ supplying a ``depends_on`` call in the package definition. For example:
depends_on("adept-utils")
depends_on("callpath")
-Here, ``callpath`` and ``adept-utils`` are concrete pacakges, but
+Here, ``callpath`` and ``adept-utils`` are concrete packages, but
there is no actual package file for ``mpi``, so we say it is a
*virtual* package. The syntax of ``depends_on``, is the same for
both. If we look inside the package file of an MPI implementation,
@@ -1349,7 +1349,7 @@ to ``provides`` to add constraints. This allows Spack to support the
notion of *versioned interfaces*. The MPI standard has gone through
many revisions, each with new functions added, and each revision of
the standard has a version number. Some packages may require a recent
-implementation that supports MPI-3 fuctions, but some MPI versions may
+implementation that supports MPI-3 functions, but some MPI versions may
only provide up to MPI-2. Others may need MPI 2.1 or higher. You can
indicate this by adding a version constraint to the spec passed to
``provides``:
@@ -1381,7 +1381,7 @@ constraints on the *providing* package, or the *provider*. The
provider only provides the declared virtual spec when *it* matches
the constraints in the when clause. Here, when ``mpich`` is at
version 3 or higher, it provides MPI up to version 3. When ``mpich``
-is at version 1 or higher, it provides the MPI virtual pacakge at
+is at version 1 or higher, it provides the MPI virtual package at
version 1.
The ``when`` qualifier ensures that Spack selects a suitably high
@@ -1544,7 +1544,7 @@ software should be installed.
Spack provides wrapper functions for ``configure`` and ``make`` so
that you can call them in a similar way to how you'd call a shell
-comamnd. In reality, these are Python functions. Spack provides
+command. In reality, these are Python functions. Spack provides
these functions to make writing packages more natural. See the section
on :ref:`shell wrappers <shell-wrappers>`.
@@ -1603,7 +1603,7 @@ The install environment
--------------------------
In general, you should not have to do much differently in your install
-method than you would when installing a pacakge on the command line.
+method than you would when installing a package on the command line.
In fact, you may need to do *less* than you would on the command line.
Spack tries to set environment variables and modify compiler calls so
@@ -1626,7 +1626,7 @@ purposes:
#. Make build systems use Spack's compiler wrappers for their builds.
#. Allow build systems to find dependencies more easily
-The Compiler enviroment variables that Spack sets are:
+The Compiler environment variables that Spack sets are:
============ ===============================
Variable Purpose
@@ -1656,7 +1656,7 @@ entering ``install()`` so that packages can locate dependencies
easily:
======================= =============================
- ``PATH`` Set to point to ``/bin`` directories of dpeendencies
+ ``PATH`` Set to point to ``/bin`` directories of dependencies
``CMAKE_PREFIX_PATH`` Path to dependency prefixes for CMake
``PKG_CONFIG_PATH`` Path to any pkgconfig directories for dependencies
``PYTHONPATH`` Path to site-packages dir of any python dependencies
@@ -1742,7 +1742,7 @@ the command line.
Forking ``install()``
~~~~~~~~~~~~~~~~~~~~~
-To give packagers free reign over their install environemnt, Spack
+To give packagers free reign over their install environment, Spack
forks a new process each time it invokes a package's ``install()``
method. This allows packages to have their own completely sandboxed
build environment, without impacting other jobs that the main Spack
@@ -1870,7 +1870,7 @@ dependency version.
You can use ``satisfies()`` to test for particular dependencies,
e.g. ``foo.satisfies('^openmpi@1.2')`` or ``foo.satisfies('^mpich')``,
-or you can use Python's builtin ``in`` operator:
+or you can use Python's built-in ``in`` operator:
.. code-block:: python
@@ -1899,7 +1899,7 @@ Accessing Dependencies
~~~~~~~~~~~~~~~~~~~~~~~~~~
You may need to get at some file or binary that's in the prefix of one
-of your dependencies. You can do that by subscripting the spec:
+of your dependencies. You can do that by sub-scripting the spec:
.. code-block:: python
@@ -2219,7 +2219,7 @@ File functions
Create an empty file at ``path``.
-.. _pacakge-lifecycle:
+.. _package-lifecycle:
Packaging workflow commands
---------------------------------
@@ -2248,7 +2248,7 @@ A typical package workflow might look like this:
... repeat clean/install until install works ...
Below are some commands that will allow you some finer-grained
-controll over the install process.
+control over the install process.
.. _spack-fetch:
@@ -2325,7 +2325,7 @@ Keeping the stage directory on success
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
By default, ``spack install`` will delete the staging area once a
-pacakge has been successfully built and installed. Use
+package has been successfully built and installed. Use
``--keep-stage`` to leave the build directory intact:
.. code-block:: sh
@@ -2474,7 +2474,7 @@ build it:
/Users/gamblin2/src/spack/var/spack/stage/libelf@0.8.13%gcc@4.8.3=linux-ppc64/libelf-0.8.13
``spack cd`` here changed he current working directory to the
-directory containing theexpanded ``libelf`` source code. There are a
+directory containing the expanded ``libelf`` source code. There are a
number of other places you can cd to in the spack directory hierarchy:
.. command-output:: spack cd -h
diff --git a/lib/spack/docs/site_configuration.rst b/lib/spack/docs/site_configuration.rst
index e076aec763..44071bbfc6 100644
--- a/lib/spack/docs/site_configuration.rst
+++ b/lib/spack/docs/site_configuration.rst
@@ -9,7 +9,7 @@ Temporary space
----------------------------
.. warning:: Temporary space configuration will be moved to configuration files.
- The intructions here are old and refer to ``__init__.py``
+ The instructions here are old and refer to ``__init__.py``
By default, Spack will try to do all of its building in temporary
space. There are two main reasons for this. First, Spack is designed
@@ -93,7 +93,7 @@ the virtual spec to specs for possible implementations, and
later, so there is no need to fully concretize the spec when returning
it.
-The ``DefaultConcretizer`` is intendend to provide sensible defaults
+The ``DefaultConcretizer`` is intended to provide sensible defaults
for each policy, but there are certain choices that it can't know
about. For example, one site might prefer ``OpenMPI`` over ``MPICH``,
or another might prefer an old version of some packages. These types
@@ -139,7 +139,7 @@ The next time you run Spack, your changes should take effect.
Profiling
~~~~~~~~~~~~~~~~~~~~~
-Spack has some limited builtin support for profiling, and can report
+Spack has some limited built-in support for profiling, and can report
statistics using standard Python timing tools. To use this feature,
supply ``-p`` to Spack on the command line, before any subcommands.
@@ -181,6 +181,6 @@ supply ``-p`` to Spack on the command line, before any subcommands.
...
The bottom of the output shows the top most time consuming functions,
-slowest on top. The profiling support is from Python's builtin tool,
+slowest on top. The profiling support is from Python's built-in tool,
`cProfile
<https://docs.python.org/2/library/profile.html#module-cProfile>`_.