Add some information about --warn=target-not-built to the troubleshooting

page.

2 files changed, 19 insertions, 1 deletions

diff --git a/doc/generated/examples/troubleshoot_explain1_3.xml b/doc/generated/examples/troubleshoot_explain1_3.xml
new file mode 100644
index 00000000..b62be879
--- /dev/null
+++ b/doc/generated/examples/troubleshoot_explain1_3.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --warn=target-not-built</userinput>
+scons: building `file.out' because it doesn't exist
+cp file.in file.oout
+
+scons: warning: Cannot find target file.out after building
+</screen>
diff --git a/doc/user/troubleshoot.xml b/doc/user/troubleshoot.xml
index 94af7275..634c7a67 100644
--- a/doc/user/troubleshoot.xml
+++ b/doc/user/troubleshoot.xml
@@ -2,7 +2,7 @@
 <!DOCTYPE sconsdoc [
     <!ENTITY % scons SYSTEM "../scons.mod">
     %scons;
-    
+
     <!ENTITY % builders-mod SYSTEM "../generated/builders.mod">
     %builders-mod;
     <!ENTITY % functions-mod SYSTEM "../generated/functions.mod">
@@ -157,6 +157,17 @@ file.in
     that something was wrong with
     the command that we invoked to build it.
 
+    <para>
+    Note that you can also use --warn=target-not-built which checks
+    whether or not expected targets exist after a build rule is
+    executed.
+    </para>
+
+    <para>
+    <scons_output example="troubleshoot_explain1" os="posix" suffix="3">
+      <scons_output_command>scons -Q --warn=target-not-built</scons_output_command>
+    </scons_output>
+
     </para>
 
     <para>