summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTodd Gamblin <tgamblin@llnl.gov>2015-02-18 14:46:00 -0800
committerTodd Gamblin <tgamblin@llnl.gov>2015-02-18 14:46:00 -0800
commit2755171e08777a2b2e8449166c792956b7e8304c (patch)
tree5f7e3da28aa784fa9a5c220754a5d63a1bb0cb9a
parente67655c31a9d98a65b3c9cd43ca329d8b97ba95b (diff)
downloadspack-2755171e08777a2b2e8449166c792956b7e8304c.tar.gz
spack-2755171e08777a2b2e8449166c792956b7e8304c.tar.bz2
spack-2755171e08777a2b2e8449166c792956b7e8304c.tar.xz
spack-2755171e08777a2b2e8449166c792956b7e8304c.zip
Update documentation to reflect new restage/clean behavior.
-rw-r--r--lib/spack/docs/packaging_guide.rst40
1 files changed, 19 insertions, 21 deletions
diff --git a/lib/spack/docs/packaging_guide.rst b/lib/spack/docs/packaging_guide.rst
index ec2ca4d099..076d3ca0e6 100644
--- a/lib/spack/docs/packaging_guide.rst
+++ b/lib/spack/docs/packaging_guide.rst
@@ -1964,35 +1964,33 @@ apply cleanly on some previous run, then it will restage the entire
package before patching.
-``spack clean``
+``spack restage``
~~~~~~~~~~~~~~~~~
+Restores the source code to pristine state, as it was before building.
-There are several variations of ``spack clean``. With no arguments,
-``spack clean`` runs ``make clean`` in the expanded archive directory.
-This is useful if an attempted build failed, and something needs to be
-changed to get a package to build. If a particular package does not
-have a ``make clean`` target, this will do nothing.
+Does this in one of two ways:
+
+ 1. If the source was fetched as a tarball, deletes the entire build
+ directory and re-expands the tarball.
+
+ 2. If the source was checked out from a repository, this deletes the
+ build directory and checks it out again.
-``spack clean -w / --work``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Deletes the entire build directory and re-expands it from the downloaded
-archive. This is useful if a package does not support a proper ``make clean``
-target.
-``spack clean -d / --dist``
+``spack clean``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Deletes the build directory *and* the downloaded archive. If
-``fetch``, ``stage``, or ``install`` are run again after this, the
-process will start from scratch, and the archive archive will be
-downloaded again. Useful if somehow a bad archive is downloaded
-accidentally and needs to be cleaned out of the staging area.
+Cleans up temporary files for a particular package, by deleting the
+expanded/checked out source code *and* any downloaded archive. If
+``fetch``, ``stage``, or ``install`` are run again after this, Spack's
+build process will start from scratch.
+
``spack purge``
~~~~~~~~~~~~~~~~~
-
-Cleans up *everything* in the build directory. You can use this to
-recover disk space if temporary files from interrupted or failed
-installs accumulate in the staging area.
+Cleans up all of Spack's temporary files. Use this to recover disk
+space if temporary files from interrupted or failed installs
+accumulate in the staging area. This is equivalent to running ``spack
+clean`` for every package you have fetched or staged.
Keeping the stage directory on success