diff options
| author | Gary Oberbrunner <garyo@oberbrunner.com> | 2011-03-01 01:01:47 (GMT) |
|---|---|---|
| committer | Gary Oberbrunner <garyo@oberbrunner.com> | 2011-03-01 01:01:47 (GMT) |
| commit | efb0071db2ef9b2ef9687e1353724ed18db1ee9b (patch) | |
| tree | 88104462b1961c598053143bfacb03286dcb821b /doc/user/troubleshoot.xml | |
| parent | f6027721b125af34862d1ba7ca5ba2205a09e1fe (diff) | |
| download | SCons-efb0071db2ef9b2ef9687e1353724ed18db1ee9b.zip SCons-efb0071db2ef9b2ef9687e1353724ed18db1ee9b.tar.gz SCons-efb0071db2ef9b2ef9687e1353724ed18db1ee9b.tar.bz2 | |
New debug option --debug=duplicate to debug Variant-dir duplication
Diffstat (limited to 'doc/user/troubleshoot.xml')
| -rw-r--r-- | doc/user/troubleshoot.xml | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/user/troubleshoot.xml b/doc/user/troubleshoot.xml index 586612a..c2a31b7 100644 --- a/doc/user/troubleshoot.xml +++ b/doc/user/troubleshoot.xml @@ -1275,6 +1275,28 @@ </section> + <section> + + <title>Why is a file disappearing? the --debug=duplicate Option</title> + + <para> + + When using the &Duplicate; option to create variant dirs, + sometimes you may find files not getting copied to where you + expect (or not at all), or files mysteriously disappearing. These + are usually because of a misconfiguration of some kind in the + SConstruct/SConscript, but they can be tricky to debug. The + --debug=duplicate option shows each time a variant file is + unlinked and relinked from its source (or copied, depending on + settings), and also shows a message for removing "stale" + variant-dir files that no longer have a corresponding source file. + It also prints a line for each target that's removed just before + building, since that can also be mistaken for the same thing. + + </para> + + </section> + <!-- <section> |