Imported Upstream version 2.4.1upstream/2.4.1

1 files changed, 22 insertions, 0 deletions

diff --git a/doc/user/output.xml b/doc/user/output.xml
index 3af96b4..5230e5c 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