diff options
Diffstat (limited to 'doc/user/troubleshoot.in')
-rw-r--r-- | doc/user/troubleshoot.in | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/doc/user/troubleshoot.in b/doc/user/troubleshoot.in index b0e8681..b237cbb 100644 --- a/doc/user/troubleshoot.in +++ b/doc/user/troubleshoot.in @@ -857,8 +857,31 @@ </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> <title>Where Are My Build Bottlenecks? the &profile; Option</title> |