diff options
| author | Gary Oberbrunner <garyo@oberbrunner.com> | 2011-03-01 00:48:34 (GMT) |
|---|---|---|
| committer | Gary Oberbrunner <garyo@oberbrunner.com> | 2011-03-01 00:48:34 (GMT) |
| commit | f6027721b125af34862d1ba7ca5ba2205a09e1fe (patch) | |
| tree | 42c19eb88c9178695c1c3a268b61140ea40ab637 /doc | |
| parent | 925ece49f121303e558f9d63b1c138f814465fc8 (diff) | |
| download | SCons-f6027721b125af34862d1ba7ca5ba2205a09e1fe.zip SCons-f6027721b125af34862d1ba7ca5ba2205a09e1fe.tar.gz SCons-f6027721b125af34862d1ba7ca5ba2205a09e1fe.tar.bz2 | |
New debug option --debug=prepare to watch targets being prepared
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/man/scons.1 | 12 | ||||
| -rw-r--r-- | doc/user/troubleshoot.in | 15 | ||||
| -rw-r--r-- | doc/user/troubleshoot.xml | 15 |
3 files changed, 42 insertions, 0 deletions
diff --git a/doc/man/scons.1 b/doc/man/scons.1 index 5d3cfd9..3fa9e0c 100644 --- a/doc/man/scons.1 +++ b/doc/man/scons.1 @@ -664,6 +664,18 @@ Re-run SCons under the control of the Python debugger. .TP +--debug=prepare +Print a line each time any target (internal or external) +is prepared for building. +.B scons +prints this for each target it considers, even if that +target is up to date (see also --debug=explain). +This can help debug problems with targets that aren't being +built; it shows whether +.B scons +is at least considering them or not. + +.TP --debug=presub Print the raw command line used to build each target before the construction environment variables are substituted. diff --git a/doc/user/troubleshoot.in b/doc/user/troubleshoot.in index 392caf6..b0e8681 100644 --- a/doc/user/troubleshoot.in +++ b/doc/user/troubleshoot.in @@ -842,6 +842,21 @@ </section> + <section> + + <title>Watch &SCons; prepare targets for building: the &debug-prepare; Option</title> + + <para> + + Sometimes SCons doesn't build the target you want + and it's difficult to figure out why. You can use + the <literal>--debug=prepare</literal> option + to see all the targets &SCons; is considering, whether + they are already up-to-date or not. The message is + printed before &SCons; decides whether to build the target. + + </section> + <!-- <section> diff --git a/doc/user/troubleshoot.xml b/doc/user/troubleshoot.xml index 26e6996..586612a 100644 --- a/doc/user/troubleshoot.xml +++ b/doc/user/troubleshoot.xml @@ -1260,6 +1260,21 @@ </section> + <section> + + <title>Watch &SCons; prepare targets for building: the &debug-prepare; Option</title> + + <para> + + Sometimes SCons doesn't build the target you want + and it's difficult to figure out why. You can use + the <literal>--debug=prepare</literal> option + to see all the targets &SCons; is considering, whether + they are already up-to-date or not. The message is + printed before &SCons; decides whether to build the target. + + </section> + <!-- <section> |