summaryrefslogtreecommitdiffstats
path: root/doc/user/troubleshoot.xml
diff options
context:
space:
mode:
authorGary Oberbrunner <garyo@oberbrunner.com>2011-03-01 00:48:34 (GMT)
committerGary Oberbrunner <garyo@oberbrunner.com>2011-03-01 00:48:34 (GMT)
commitf6027721b125af34862d1ba7ca5ba2205a09e1fe (patch)
tree42c19eb88c9178695c1c3a268b61140ea40ab637 /doc/user/troubleshoot.xml
parent925ece49f121303e558f9d63b1c138f814465fc8 (diff)
downloadSCons-f6027721b125af34862d1ba7ca5ba2205a09e1fe.zip
SCons-f6027721b125af34862d1ba7ca5ba2205a09e1fe.tar.gz
SCons-f6027721b125af34862d1ba7ca5ba2205a09e1fe.tar.bz2
New debug option --debug=prepare to watch targets being prepared
Diffstat (limited to 'doc/user/troubleshoot.xml')
-rw-r--r--doc/user/troubleshoot.xml15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/user/troubleshoot.xml b/doc/user/troubleshoot.xml
index 26e6996..586612a 100644
--- a/doc/user/troubleshoot.xml
+++ b/doc/user/troubleshoot.xml
@@ -1260,6 +1260,21 @@
</section>
+ <section>
+
+ <title>Watch &SCons; prepare targets for building: the &debug-prepare; Option</title>
+
+ <para>
+
+ Sometimes SCons doesn't build the target you want
+ and it's difficult to figure out why. You can use
+ the <literal>--debug=prepare</literal> option
+ to see all the targets &SCons; is considering, whether
+ they are already up-to-date or not. The message is
+ printed before &SCons; decides whether to build the target.
+
+ </section>
+
<!--
<section>