From 36aa3bb0374fdedd29bd68aa849ab395acecd4c8 Mon Sep 17 00:00:00 2001
From: Tom Tanner <ttanner2@bloomberg.net>
Date: Mon, 4 Nov 2013 10:15:12 +0000
Subject: Add some information about --warn=target-not-built to the
 troubleshooting page.

---
 doc/generated/examples/troubleshoot_explain1_3.xml |  7 +++++++
 doc/user/troubleshoot.xml                          | 13 ++++++++++++-
 2 files changed, 19 insertions(+), 1 deletion(-)
 create mode 100644 doc/generated/examples/troubleshoot_explain1_3.xml

diff --git a/doc/generated/examples/troubleshoot_explain1_3.xml b/doc/generated/examples/troubleshoot_explain1_3.xml
new file mode 100644
index 0000000..b62be87
--- /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 94af727..634c7a6 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>
-- 
cgit v0.12