diff --git a/doc/manual/advanced-topics/distributed-builds.xml b/doc/manual/advanced-topics/distributed-builds.xml
index ce2e077ed..9ac4a92cd 100644
--- a/doc/manual/advanced-topics/distributed-builds.xml
+++ b/doc/manual/advanced-topics/distributed-builds.xml
@@ -184,4 +184,7 @@ to be included. (This is the default.)
the option builders-use-substitutes
in your local nix.conf.
+To build only on remote builders and disable building on the local machine,
+you can use the option .
+
diff --git a/doc/manual/command-ref/opt-common.xml b/doc/manual/command-ref/opt-common.xml
index 4c572e129..b8a2f260e 100644
--- a/doc/manual/command-ref/opt-common.xml
+++ b/doc/manual/command-ref/opt-common.xml
@@ -107,14 +107,22 @@
/
number
- Sets the maximum number of build jobs that Nix will
+
+
+ Sets the maximum number of build jobs that Nix will
perform in parallel to the specified number. Specify
auto to use the number of CPUs in the system.
The default is specified by the max-jobs
configuration setting, which itself defaults to
1. A higher value is useful on SMP systems or to
- exploit I/O latency.
+ exploit I/O latency.
+
+ Setting it to 0 disallows building on the local
+ machine, which is useful when you want builds to happen only on remote
+ builders.
+
+