summaryrefslogtreecommitdiffstats
path: root/doc/user
diff options
context:
space:
mode:
authorWilliam Deegan <bill@baddogconsulting.com>2015-09-28 21:02:37 (GMT)
committerWilliam Deegan <bill@baddogconsulting.com>2015-09-28 21:02:37 (GMT)
commit11addeb3aef797cce9414a51b4229da51f3780a1 (patch)
tree7b8573350bc25cd1b78f8b9f8f5f2b7a55692679 /doc/user
parentb2b1d5d272bdcfe1f9dc7c4bc57b8c8927fe7784 (diff)
parent898fa44b70ce4998801db843dbe5b263f4d34a18 (diff)
downloadSCons-11addeb3aef797cce9414a51b4229da51f3780a1.zip
SCons-11addeb3aef797cce9414a51b4229da51f3780a1.tar.gz
SCons-11addeb3aef797cce9414a51b4229da51f3780a1.tar.bz2
merge
Diffstat (limited to 'doc/user')
-rw-r--r--doc/user/output.xml22
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