Add subdirectories

darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz

1 files changed, 30 insertions, 0 deletions

diff --git a/doc_src/begin.txt b/doc_src/begin.txt
new file mode 100644
index 00000000..02284f21
--- /dev/null
+++ b/doc_src/begin.txt
@@ -0,0 +1,30 @@
+
+\section begin begin - Start a new block of code
+
+\subsection begin-synopsis Synopsis
+ <tt>begin; [COMMAND;...] end </tt>
+
+\subsection begin-description Description
+
+The \c begin builtin is used to create a new block of code. The block
+is unconditionally erxecuted. 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 ot output of this set of
+commands as a group.
+
+\subsection begin-example Example
+
+The following code sets a number of variables inside of a block
+scope. Since the variables are set inside the block and have local
+scope, they will be automatically deleted when the block ends.
+
+<pre>
+begin
+	set -x PIRATE Yarrr
+	...
+end
+# This will not output anything, since PIRATE went out of scope at the end of
+# the block and was killed
+echo $PIRATE
+</pre>