summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTom Tanner <ttanner2@bloomberg.net>2013-11-04 10:15:12 (GMT)
committerTom Tanner <ttanner2@bloomberg.net>2013-11-04 10:15:12 (GMT)
commit36aa3bb0374fdedd29bd68aa849ab395acecd4c8 (patch)
tree0053fab99c6b27e38b9493a6ddf124bf75f2eca4
parent396cc5ff8cce251f405e3eba6163362239ce7d08 (diff)
downloadSCons-36aa3bb0374fdedd29bd68aa849ab395acecd4c8.zip
SCons-36aa3bb0374fdedd29bd68aa849ab395acecd4c8.tar.gz
SCons-36aa3bb0374fdedd29bd68aa849ab395acecd4c8.tar.bz2
Add some information about --warn=target-not-built to the troubleshooting
page.
-rw-r--r--doc/generated/examples/troubleshoot_explain1_3.xml7
-rw-r--r--doc/user/troubleshoot.xml13
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 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>