diff options
| author | Tom Tanner <ttanner2@bloomberg.net> | 2013-11-04 10:15:12 (GMT) |
|---|---|---|
| committer | Tom Tanner <ttanner2@bloomberg.net> | 2013-11-04 10:15:12 (GMT) |
| commit | 36aa3bb0374fdedd29bd68aa849ab395acecd4c8 (patch) | |
| tree | 0053fab99c6b27e38b9493a6ddf124bf75f2eca4 | |
| parent | 396cc5ff8cce251f405e3eba6163362239ce7d08 (diff) | |
| download | SCons-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.xml | 7 | ||||
| -rw-r--r-- | doc/user/troubleshoot.xml | 13 |
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> |