nixo
/
guix-devel
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

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'.
master
Ludovic Courtès 2013-09-27 01:26:26 +02:00
parent d7ddb257c9
commit 1bb9900a2a
1 changed files with 9 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
doc/guix.texi
View File

@ -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 switching to the previous available generation. Note that the zeroth
generation is never deleted. generation is never deleted.
Note that deleting generations prevents roll-back to them.
Consequently, this command must be used with care.
@end table @end table
@node Packages with Multiple Outputs @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 profiles, and may be augmented with @command{guix build --root}, for
example (@pxref{Invoking guix build}). 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 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 used to garbage-collect any dead files (the default), to delete specific
files (the @code{--delete} option), or to print garbage-collector files (the @code{--delete} option), or to print garbage-collector