diff --git a/doc/manual/command-ref/conf-file.xml b/doc/manual/command-ref/conf-file.xml
index 4f7393e2e..0a97719ef 100644
--- a/doc/manual/command-ref/conf-file.xml
+++ b/doc/manual/command-ref/conf-file.xml
@@ -483,8 +483,10 @@ builtins.fetchurl {
max-free
- This option defines after how many free bytes to stop collecting
- garbage once the min-free condition gets triggered.
+ When a garbage collection is triggered by the
+ min-free option, it stops as soon as
+ max-free bytes are available. The default is
+ infinity (i.e. delete all garbage).
@@ -528,9 +530,11 @@ builtins.fetchurl {
min-free
- When the disk reaches min-free bytes of free disk space during a build, nix
- will start to garbage-collection until max-free bytes are available on the disk.
- A value of 0 (the default) means that this feature is disabled.
+ When free disk space in /nix/store
+ drops below min-free during a build, Nix
+ performs a garbage-collection until max-free
+ bytes are available or there is no more garbage. A value of
+ 0 (the default) disables this feature.