diff options
| author | William Deegan <bill@baddogconsulting.com> | 2015-09-28 20:57:59 (GMT) |
|---|---|---|
| committer | William Deegan <bill@baddogconsulting.com> | 2015-09-28 20:57:59 (GMT) |
| commit | 898fa44b70ce4998801db843dbe5b263f4d34a18 (patch) | |
| tree | 992bf7275932e5d91280d5fd0e1376e6f2f92520 /doc/user/output.xml | |
| parent | 3359572ab98baf9f408c7e86ad0d2df9a50594a4 (diff) | |
| download | SCons-898fa44b70ce4998801db843dbe5b263f4d34a18.zip SCons-898fa44b70ce4998801db843dbe5b263f4d34a18.tar.gz SCons-898fa44b70ce4998801db843dbe5b263f4d34a18.tar.bz2 | |
Added help for pull request #226
Diffstat (limited to 'doc/user/output.xml')
| -rw-r--r-- | doc/user/output.xml | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/user/output.xml b/doc/user/output.xml index cdb28d7..78dcca4 100644 --- a/doc/user/output.xml +++ b/doc/user/output.xml @@ -83,6 +83,21 @@ Type: 'scons program' to build the production program, <para> + Optionally, one can specify the append flag: + + </para> + + <scons_example name="output_ex1_a"> + <file name="SConstruct" printme="1"> +Help(""" +Type: 'scons program' to build the production program, + 'scons debug' to build the debug version. +""", append=True) + </file> + </scons_example> + + <para> + (Note the above use of the Python triple-quote syntax, which comes in very handy for specifying multi-line strings like help text.) @@ -120,6 +135,13 @@ Type: 'scons program' to build the production program, <para> + When used with &AddOption; Help("text", append=False) will clobber any help output associated with AddOption(). + To preserve the help output from AddOption(), set append=True. + + </para> + + <para> + Another use would be to make the help text conditional on some variable. For example, suppose you only want to display |