about summary refs log tree commit diff
path: root/doc/manual/packages/garbage-collection.xml
diff options
context:
space:
mode:
authorShea Levy <shea@shealevy.com>2018-04-12T10·12-0400
committerGitHub <noreply@github.com>2018-04-12T10·12-0400
commit3d748d3323abe1d5f2787b1f9a64eb453a918d0e (patch)
tree7eb49aa898dbec9f21d052da4da08003cd06c1e1 /doc/manual/packages/garbage-collection.xml
parentdc0a542c9f8c839b8437b54fcf1c4b47b0cfba10 (diff)
parent2ef8f0608caa27d1a92d827f54b54155c89092a8 (diff)
Merge pull request #2071 from sseefried-forked/clarify-glossary-and-garbage-collection
Add to glossary and clarify garbage collection
Diffstat (limited to 'doc/manual/packages/garbage-collection.xml')
-rw-r--r--doc/manual/packages/garbage-collection.xml8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/manual/packages/garbage-collection.xml b/doc/manual/packages/garbage-collection.xml
index 03b8e4c976c1..a1b0ef22a11e 100644
--- a/doc/manual/packages/garbage-collection.xml
+++ b/doc/manual/packages/garbage-collection.xml
@@ -52,6 +52,14 @@ garbage collector as follows:
 <screen>
 $ nix-store --gc</screen>
 
+The behaviour of the gargage collector is affected by the <literal>keep-
+derivations</literal> (default: true) and <literal>keep-outputs</literal>
+(default: false) options in the Nix configuration file. The defaults will ensure
+that all derivations that are not build-time dependencies of garbage collector roots
+will be collected but that all output paths that are not runtime dependencies
+will be collected. (This is usually what you want, but while you are developing
+it may make sense to keep outputs to ensure that rebuild times are quick.)
+
 If you are feeling uncertain, you can also first view what files would
 be deleted: