summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorPaul Hopkins <paul.hopkins@ligo.org>2016-07-11 12:03:28 +0100
committerPaul Hopkins <paul.hopkins@ligo.org>2016-07-21 12:32:00 +0100
commit480fe9cb9ac2e0c6e2da4557abe9fd99fff6c64d (patch)
treed42e6e5d3ddc6bd20d788eed5c27bd5af0894adc /lib
parentbd91dd9d6d4607fd603cc1f3baaf753a5f4915bf (diff)
downloadspack-480fe9cb9ac2e0c6e2da4557abe9fd99fff6c64d.tar.gz
spack-480fe9cb9ac2e0c6e2da4557abe9fd99fff6c64d.tar.bz2
spack-480fe9cb9ac2e0c6e2da4557abe9fd99fff6c64d.tar.xz
spack-480fe9cb9ac2e0c6e2da4557abe9fd99fff6c64d.zip
Re-add documentation for variant preferences
Diffstat (limited to 'lib')
-rw-r--r--lib/spack/docs/configuration.rst11
1 files changed, 6 insertions, 5 deletions
diff --git a/lib/spack/docs/configuration.rst b/lib/spack/docs/configuration.rst
index f2ffa07264..d39c932021 100644
--- a/lib/spack/docs/configuration.rst
+++ b/lib/spack/docs/configuration.rst
@@ -142,8 +142,9 @@ Here's an example packages.yaml file that sets preferred packages:
.. code-block:: sh
packages:
- dyninst:
+ opencv:
compiler: [gcc@4.9]
+ variants: +debug
gperftools:
version: [2.2, 2.4, 2.3]
all:
@@ -153,17 +154,17 @@ Here's an example packages.yaml file that sets preferred packages:
At a high level, this example is specifying how packages should be
-concretized. The dyninst package should prefer using gcc 4.9.
-The gperftools package should prefer version
+concretized. The opencv package should prefer using gcc 4.9 and
+be built with debug options. The gperftools package should prefer version
2.2 over 2.4. Every package on the system should prefer mvapich for
-its MPI and gcc 4.4.7 (except for Dyninst, which overrides this by preferring gcc 4.9).
+its MPI and gcc 4.4.7 (except for opencv, which overrides this by preferring gcc 4.9).
These options are used to fill in implicit defaults. Any of them can be overwritten
on the command line if explicitly requested.
Each packages.yaml file begins with the string ``packages:`` and
package names are specified on the next level. The special string ``all``
applies settings to each package. Underneath each package name is
-one or more components: ``compiler``, ``version``,
+one or more components: ``compiler``, ``variants``, ``version``,
or ``providers``. Each component has an ordered list of spec
``constraints``, with earlier entries in the list being preferred over
later entries.