diff options
author | Gary Oberbrunner <garyo@oberbrunner.com> | 2013-11-10 03:48:37 (GMT) |
---|---|---|
committer | Gary Oberbrunner <garyo@oberbrunner.com> | 2013-11-10 03:48:37 (GMT) |
commit | a8261e0d41be63ca45462fb0f40e8ed1339cc22e (patch) | |
tree | d6da4414d804e0115c17efdc26609d18659809c8 /doc | |
parent | 703ba43b17517810162d91b109b54fc76868eee6 (diff) | |
parent | 425a1f0df64d016128a98098b30f7d0e1ebd8de8 (diff) | |
download | SCons-a8261e0d41be63ca45462fb0f40e8ed1339cc22e.zip SCons-a8261e0d41be63ca45462fb0f40e8ed1339cc22e.tar.gz SCons-a8261e0d41be63ca45462fb0f40e8ed1339cc22e.tar.bz2 |
Merged in thosrtanner/trt_scons_missing_doc (pull request #95)
Add some information about --warn=target-not-built to the troubleshooting
Diffstat (limited to 'doc')
-rw-r--r-- | doc/generated/examples/troubleshoot_explain1_3.xml | 7 | ||||
-rw-r--r-- | doc/user/troubleshoot.xml | 12 |
2 files changed, 18 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..65c9199 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"> @@ -160,6 +160,16 @@ file.in </para> <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> + + <scons_output example="troubleshoot_explain1" os="posix" suffix="3"> + <scons_output_command>scons -Q --warn=target-not-built</scons_output_command> + </scons_output> + + <para> The &debug-explain; option also comes in handy to help figure out what input file changed. |