Skip to content

Commit ad829f4

Browse files
committed
fix the help text output
1 parent b934ae5 commit ad829f4

1 file changed

Lines changed: 60 additions & 34 deletions

File tree

outputs/basics/help-spec.out

Lines changed: 60 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,60 @@
1-
usage: spack spec [-hlLNtU] [-I | --no-install-status] [-y | -j | --format FORMAT] [-c {nodes,edges,paths}] [--reuse] [--fresh-roots] [--deprecated] ...
2-
3-
show what would be installed, given a spec
4-
5-
positional arguments:
6-
specs one or more package specs
7-
8-
options:
9-
--format FORMAT print concrete spec with the specified format string
10-
--no-install-status do not show install status annotations
11-
-I, --install-status show install status of packages
12-
[+] installed [^] installed in an upstream
13-
- not installed [-] missing dep of installed package
14-
-L, --very-long show full dependency hashes as well as versions
15-
-N, --namespaces show fully qualified package names
16-
-c, --cover {nodes,edges,paths}
17-
how extensively to traverse the DAG (default: nodes)
18-
-h, --help show this help message and exit
19-
-j, --json print concrete spec as JSON
20-
-l, --long show dependency hashes as well as versions
21-
-t, --types show dependency types
22-
-y, --yaml print concrete spec as YAML
23-
24-
concretizer arguments:
25-
--deprecated allow concretizer to select deprecated versions
26-
--fresh-roots, --reuse-deps
27-
concretize with fresh roots and reused dependencies
28-
--reuse reuse installed packages/buildcaches when possible
29-
-U, --fresh do not reuse installed deps; build newest configuration
30-
31-
when an environment is active and no specs are provided, the environment root specs are used instead
32-
33-
for further documentation regarding the spec syntax, see:
34-
spack help --spec
1+
spec expression syntax:
2+
3+
package [constraints] [^dependency [constraints] ...]
4+
5+
package any package from 'spack list', or
6+
/hash unique prefix or full hash of
7+
installed package
8+
9+
constraints:
10+
versions:
11+
@version single version
12+
@min:max version range (inclusive)
13+
@min: version <min> or higher
14+
@:max up to version <max> (inclusive)
15+
@=version exact version
16+
17+
compilers:
18+
%compiler build with <compiler>
19+
%compiler@version build with specific compiler version
20+
%compiler@min:max specific version range (see above)
21+
22+
compiler flags:
23+
cflags="flags" cppflags, cflags, cxxflags,
24+
fflags, ldflags, ldlibs
25+
== propagate flags to package dependencies
26+
27+
variants:
28+
+variant enable <variant>
29+
-variant or ~variant disable <variant>
30+
variant=value set non-boolean <variant> to <value>
31+
variant=value1,value2,value3 set multi-value <variant> values
32+
++, --, ~~, == propagate variants to package dependencies
33+
34+
architecture variants:
35+
platform=platform linux, darwin, freebsd, windows
36+
os=operating_system specific <operating_system>
37+
target=target specific <target> processor
38+
arch=platform-os-target shortcut for all three above
39+
40+
dependencies:
41+
^dependency [constraints] specify constraints on dependencies
42+
^/hash build with a specific installed
43+
dependency
44+
45+
examples:
46+
hdf5 any hdf5 configuration
47+
hdf5 @1.10.1 hdf5 version 1.10.1
48+
hdf5 @1.8: hdf5 1.8 or higher
49+
hdf5 @1.8: %gcc hdf5 1.8 or higher built with gcc
50+
hdf5 +mpi hdf5 with mpi enabled
51+
hdf5 ~mpi hdf5 with mpi disabled
52+
hdf5 ++mpi hdf5 with mpi enabled and propagates
53+
hdf5 ~~mpi hdf5 with mpi disabled and propagates
54+
hdf5 +mpi ^mpich hdf5 with mpi, using mpich
55+
hdf5 +mpi ^openmpi@1.7 hdf5 with mpi, using openmpi 1.7
56+
boxlib dim=2 boxlib built for 2 dimensions
57+
libdwarf %intel ^libelf%gcc
58+
libdwarf, built with intel compiler, linked to libelf built with gcc
59+
mvapich2 fabrics=psm,mrail,sock %gcc
60+
mvapich2, built with gcc compiler, with support for multiple fabrics

0 commit comments

Comments
 (0)