From 684c7fff80b575da8055015c6b87693fd1d858ca Mon Sep 17 00:00:00 2001
From: Joachim Breitner <mail@joachim-breitner.de>
Date: Sat, 16 Mar 2019 19:03:03 +0100
Subject: [PATCH] Link to `builders-use-substitutes` in chapter on distributed
 builds

fixes #2730.
---
 doc/manual/advanced-topics/distributed-builds.xml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/manual/advanced-topics/distributed-builds.xml b/doc/manual/advanced-topics/distributed-builds.xml
index bbb573e35..ce2e077ed 100644
--- a/doc/manual/advanced-topics/distributed-builds.xml
+++ b/doc/manual/advanced-topics/distributed-builds.xml
@@ -180,4 +180,8 @@ builders = @/etc/nix/machines
 causes the list of machines in <filename>/etc/nix/machines</filename>
 to be included. (This is the default.)</para>
 
+<para>If you want the builders to use caches, you likely want to set
+the option <link linkend='conf-builders-use-substitutes'><literal>builders-use-substitutes</literal></link>
+in your local <filename>nix.conf</filename>.</para>
+
 </chapter>