rework spack help (#3033)
- Full help is now only generated lazily, when needed. - Executing specific commands doesn't require loading all of them. - All commands are only loaded if we need them for help. - There is now short and long help: - short help (spack help) shows only basic spack options - long help (spack help -a) shows all spack options - Both divide help on commands into high-level sections - Commands now specify attributes from which help is auto-generated: - description: used in help to describe the command. - section: help section - level: short or long - Clean up command descriptions - Add a `spack docs` command to open full documentation in the browser. - move `spack doc` command to `spack pydoc` for clarity - Add a `spack --spec` command to show documentation on the spec syntax.
Showing
- bin/spack 21 additions, 201 deletionsbin/spack
- lib/spack/spack/__init__.py 1 addition, 1 deletionlib/spack/spack/__init__.py
- lib/spack/spack/cmd/activate.py 2 additions, 0 deletionslib/spack/spack/cmd/activate.py
- lib/spack/spack/cmd/arch.py 2 additions, 0 deletionslib/spack/spack/cmd/arch.py
- lib/spack/spack/cmd/bootstrap.py 2 additions, 0 deletionslib/spack/spack/cmd/bootstrap.py
- lib/spack/spack/cmd/build.py 3 additions, 0 deletionslib/spack/spack/cmd/build.py
- lib/spack/spack/cmd/cd.py 2 additions, 0 deletionslib/spack/spack/cmd/cd.py
- lib/spack/spack/cmd/checksum.py 2 additions, 0 deletionslib/spack/spack/cmd/checksum.py
- lib/spack/spack/cmd/clean.py 2 additions, 0 deletionslib/spack/spack/cmd/clean.py
- lib/spack/spack/cmd/compiler.py 2 additions, 0 deletionslib/spack/spack/cmd/compiler.py
- lib/spack/spack/cmd/compilers.py 3 additions, 1 deletionlib/spack/spack/cmd/compilers.py
- lib/spack/spack/cmd/config.py 2 additions, 0 deletionslib/spack/spack/cmd/config.py
- lib/spack/spack/cmd/configure.py 3 additions, 1 deletionlib/spack/spack/cmd/configure.py
- lib/spack/spack/cmd/create.py 3 additions, 0 deletionslib/spack/spack/cmd/create.py
- lib/spack/spack/cmd/deactivate.py 2 additions, 0 deletionslib/spack/spack/cmd/deactivate.py
- lib/spack/spack/cmd/debug.py 2 additions, 0 deletionslib/spack/spack/cmd/debug.py
- lib/spack/spack/cmd/dependents.py 2 additions, 0 deletionslib/spack/spack/cmd/dependents.py
- lib/spack/spack/cmd/diy.py 2 additions, 0 deletionslib/spack/spack/cmd/diy.py
- lib/spack/spack/cmd/docs.py 33 additions, 0 deletionslib/spack/spack/cmd/docs.py
- lib/spack/spack/cmd/edit.py 2 additions, 0 deletionslib/spack/spack/cmd/edit.py
Loading
Please register or sign in to comment