summary refs log tree commit diff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2013-09-27 01:26:26 +0200
committerLudovic Courtès <ludo@gnu.org>2013-09-27 01:26:26 +0200
commit1bb9900a2a2fccfca3aa2ebb26dcc20095d230e5 (patch)
tree46e88232870822cd64a308ec0275af571de3d6ca
parentd7ddb257c9d22c794d6b26af64a57901ccee71e0 (diff)
downloadguix-1bb9900a2a2fccfca3aa2ebb26dcc20095d230e5.tar.gz
doc: Link from "guix gc" to '--delete-generations'.
* doc/guix.texi (Invoking guix package): Mention that deleting
  generations prevents roll-back.
  (Invoking guix gc): Link to '--delete-generations'.
-rw-r--r--doc/guix.texi9
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 29928c5af4..94658f2b21 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -730,6 +730,9 @@ If the current generation matches, it is deleted atomically---i.e., by
 switching to the previous available generation.  Note that the zeroth
 generation is never deleted.
 
+Note that deleting generations prevents roll-back to them.
+Consequently, this command must be used with care.
+
 @end table
 
 @node Packages with Multiple Outputs
@@ -797,6 +800,12 @@ deleted.  The set of garbage collector roots includes default user
 profiles, and may be augmented with @command{guix build --root}, for
 example (@pxref{Invoking guix build}).
 
+Prior to running @code{guix gc --collect-garbage} to make space, it is
+often useful to remove old generations from user profiles; that way, old
+package builds referenced by those generations can be reclaimed.  This
+is achieved by running @code{guix package --delete-generations}
+(@pxref{Invoking guix package}).
+
 The @command{guix gc} command has three modes of operation: it can be
 used to garbage-collect any dead files (the default), to delete specific
 files (the @code{--delete} option), or to print garbage-collector