diff --git a/doc/manual/advanced-topics/advanced-topics.xml b/doc/manual/advanced-topics/advanced-topics.xml
new file mode 100644
index 000000000..338aa6f3a
--- /dev/null
+++ b/doc/manual/advanced-topics/advanced-topics.xml
@@ -0,0 +1,10 @@
+
+
+Advanced Topics
+
+
+
+
diff --git a/doc/manual/builds/enabling-builds.xml b/doc/manual/advanced-topics/distributed-builds.xml
similarity index 88%
rename from doc/manual/builds/enabling-builds.xml
rename to doc/manual/advanced-topics/distributed-builds.xml
index 4b45812ee..70f396f81 100644
--- a/doc/manual/builds/enabling-builds.xml
+++ b/doc/manual/advanced-topics/distributed-builds.xml
@@ -2,9 +2,18 @@
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xi="http://www.w3.org/2001/XInclude"
version="5.0"
- xml:id="ch-enabling-builds">
+ xml:id='chap-distributed-builds'>
-
Enabling Distributed Builds
+Distributed Builds
+
+Nix supports distributed builds, where a local Nix installation can
+forward Nix builds to other machines over the network. This allows
+multiple builds to be performed in parallel (thus improving
+performance) and allows Nix to perform multi-platform builds in a
+semi-transparent way. For instance, if you perform a build for a
+powerpc-darwin on an i686-linux
+machine, Nix can automatically forward the build to a
+powerpc-darwin machine, if available.
You can enable distributed builds by setting the environment
variable NIX_BUILD_HOOK to point to a program that Nix
@@ -41,7 +50,7 @@ example configuration is shown in
-
+
The name of the remote machine, with optionally the
user under which the remote build should be performed. This is
actually passed as an argument to ssh, so it can
@@ -73,9 +82,9 @@ bits of information:
build-remote.pl will only perform the
derivation on a machine that has the specified features. For
instance, the attribute
-
+
-requiredSystemFeatures = [ "kvm" ];
+requiredSystemFeatures = [ "kvm" ];
will cause the build to be performed on a machine that has the
@@ -103,4 +112,4 @@ running, they should use the same NIX_CURRENT_LOAD
file. Maybe in the future build-remote.pl will
look at the actual remote load.
-
\ No newline at end of file
+
diff --git a/doc/manual/builds/build-farm.xml b/doc/manual/builds/build-farm.xml
deleted file mode 100644
index e0e9f10f1..000000000
--- a/doc/manual/builds/build-farm.xml
+++ /dev/null
@@ -1,22 +0,0 @@
-
-
-Distributed Builds
-
-
-Nix supports distributed builds, where a local Nix installation can
-forward Nix builds to other machines over the network. This allows
-multiple builds to be performed in parallel (thus improving
-performance) and allows Nix to perform multi-platform builds in a
-semi-transparent way. For instance, if you perform a build for a
-powerpc-darwin on an i686-linux
-machine, Nix can automatically forward the build to a
-powerpc-darwin machine, if available.
-
-
-
-
-
diff --git a/doc/manual/manual.xml b/doc/manual/manual.xml
index 5c46f303a..b784bb5f3 100644
--- a/doc/manual/manual.xml
+++ b/doc/manual/manual.xml
@@ -41,7 +41,7 @@
-
+