diff options
Diffstat (limited to 'doc_src/begin.txt')
-rw-r--r-- | doc_src/begin.txt | 25 |
1 files changed, 20 insertions, 5 deletions
diff --git a/doc_src/begin.txt b/doc_src/begin.txt index 07ef10e0..62bb3810 100644 --- a/doc_src/begin.txt +++ b/doc_src/begin.txt @@ -7,11 +7,12 @@ \subsection begin-description Description The \c begin builtin is used to create a new block of code. The block -is unconditionally executed. Begin is equivalent to <tt>if -true</tt>. The begin command is used to group any number of commands -into a block. The reason for this is usually either to introduce a new -variable scope or to redirect the input to output of this set of -commands as a group. +is unconditionally executed. <code>begin; ...; end</tt> is equivalent +to <tt>if true; ...; end</tt>. The begin command is used to group any +number of commands into a block. The reason for doing so is usually +either to introduce a new variable scope, to redirect the input or +output of a set of commands as a group, or to specify precedence when +using the conditional commands like \c and. The \c begin command does not change the current exit status. @@ -30,3 +31,17 @@ end # the block and was killed echo $PIRATE </pre> + +In the following code, all output is redirected to the file out.html. + +<pre> +begin + echo $xml_header + echo $html_header + if test -e $file + ... + end + ... + +end > out.html +</pre> |