summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTodd Gamblin <tgamblin@llnl.gov>2014-06-24 17:07:18 -0700
committerTodd Gamblin <tgamblin@llnl.gov>2014-06-24 17:07:18 -0700
commit4b960c131b552ba4d847554f34a3833b0322ff9f (patch)
tree5a77ff69402497e03d9f76e1d70ae4fae1f4f61a
parent3b1e6d4bbce4ba98f1da7ffb0e69e77477ee2e18 (diff)
downloadspack-4b960c131b552ba4d847554f34a3833b0322ff9f.tar.gz
spack-4b960c131b552ba4d847554f34a3833b0322ff9f.tar.bz2
spack-4b960c131b552ba4d847554f34a3833b0322ff9f.tar.xz
spack-4b960c131b552ba4d847554f34a3833b0322ff9f.zip
Reordered site configuration docs.
-rw-r--r--lib/spack/docs/site_configuration.rst101
1 files changed, 51 insertions, 50 deletions
diff --git a/lib/spack/docs/site_configuration.rst b/lib/spack/docs/site_configuration.rst
index c7465d759b..4936e3052c 100644
--- a/lib/spack/docs/site_configuration.rst
+++ b/lib/spack/docs/site_configuration.rst
@@ -3,56 +3,6 @@
Site-specific configuration
===================================
-.. _temp-space:
-
-Temporary space
-----------------------------
-
-.. deprecated::
-
- This will be moved to configuration files.
-
-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
-to run out of a user's home directory, and on may systems the home
-directory is network mounted and potentially not a very fast
-filesystem. We create build stages in a temporary directory to avoid
-this. Second, many systems impose quotas on home directories, and
-``/tmp`` or similar directories often have more available space. This
-helps conserve space for installations in users' home directories.
-
-You can customize temporary directories by editing
-``lib/spack/spack/__init__.py``. Specifically, find this part of the file:
-
-.. code-block:: python
-
- # Whether to build in tmp space or directly in the stage_path.
- # If this is true, then spack will make stage directories in
- # a tmp filesystem, and it will symlink them into stage_path.
- use_tmp_stage = True
-
- # Locations to use for staging and building, in order of preference
- # Use a %u to add a username to the stage paths here, in case this
- # is a shared filesystem. Spack will use the first of these paths
- # that it can create.
- tmp_dirs = ['/nfs/tmp2/%u/spack-stage',
- '/var/tmp/%u/spack-stage',
- '/tmp/%u/spack-stage']
-
-The ``use_tmp_stage`` variable controls whether Spack builds
-**directly** inside the ``var/spack/`` directory. Normally, Spack
-will try to find a temporary directory for a build, then it *symlinks*
-that temporary directory into ``var/spack/`` so that you can keep
-track of what temporary directories Spack is using.
-
-The ``tmp_dirs`` variable is a list of paths Spack should search when
-trying to find a temporary directory. They can optionally contain a
-``%u``, which will substitute the current user's name into the path.
-The list is searched in order, and Spack will create a temporary stage
-in the first directory it finds to which it has write access. Add
-more elements to the list to indicate where your own site's temporary
-directory is.
-
.. _mirrors:
Mirrors
@@ -245,6 +195,57 @@ If you want to change the order in which mirrors are searched for
packages, you can edit this file and reorder the sections. Spack will
search the topmost mirror first and the bottom-most mirror last.
+
+.. _temp-space:
+
+Temporary space
+----------------------------
+
+.. warning:: Temporary space configuration will be moved to configuration files.
+ The intructions 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
+to run out of a user's home directory, and on may systems the home
+directory is network mounted and potentially not a very fast
+filesystem. We create build stages in a temporary directory to avoid
+this. Second, many systems impose quotas on home directories, and
+``/tmp`` or similar directories often have more available space. This
+helps conserve space for installations in users' home directories.
+
+You can customize temporary directories by editing
+``lib/spack/spack/__init__.py``. Specifically, find this part of the file:
+
+.. code-block:: python
+
+ # Whether to build in tmp space or directly in the stage_path.
+ # If this is true, then spack will make stage directories in
+ # a tmp filesystem, and it will symlink them into stage_path.
+ use_tmp_stage = True
+
+ # Locations to use for staging and building, in order of preference
+ # Use a %u to add a username to the stage paths here, in case this
+ # is a shared filesystem. Spack will use the first of these paths
+ # that it can create.
+ tmp_dirs = ['/nfs/tmp2/%u/spack-stage',
+ '/var/tmp/%u/spack-stage',
+ '/tmp/%u/spack-stage']
+
+The ``use_tmp_stage`` variable controls whether Spack builds
+**directly** inside the ``var/spack/`` directory. Normally, Spack
+will try to find a temporary directory for a build, then it *symlinks*
+that temporary directory into ``var/spack/`` so that you can keep
+track of what temporary directories Spack is using.
+
+The ``tmp_dirs`` variable is a list of paths Spack should search when
+trying to find a temporary directory. They can optionally contain a
+``%u``, which will substitute the current user's name into the path.
+The list is searched in order, and Spack will create a temporary stage
+in the first directory it finds to which it has write access. Add
+more elements to the list to indicate where your own site's temporary
+directory is.
+
+
.. _concretization-policies:
Concretization policies