aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc_src/while.txt
diff options
context:
space:
mode:
authorGravatar axel <axel@liljencrantz.se>2006-09-20 00:52:03 +1000
committerGravatar axel <axel@liljencrantz.se>2006-09-20 00:52:03 +1000
commit7a5823fd605af80df483e1d3f3629e60503488de (patch)
tree714e61c3c6cddec3eb7499e99121de2f3efdcb4e /doc_src/while.txt
parent81d61c467b2fc42e7e890198fb2bd203b27aff44 (diff)
Documentation updates from Beni Cherniavsky
darcs-hash:20060919145203-ac50b-bc87b8f5e6a18395e4bc3e364da4a40ad97850e7.gz
Diffstat (limited to 'doc_src/while.txt')
-rw-r--r--doc_src/while.txt12
1 files changed, 9 insertions, 3 deletions
diff --git a/doc_src/while.txt b/doc_src/while.txt
index 3a59afc5..6b2bebb0 100644
--- a/doc_src/while.txt
+++ b/doc_src/while.txt
@@ -1,13 +1,19 @@
\section while while - perform a command multiple times
\subsection while-synopsis Synopsis
-<tt>while CONDITION; COMMANDS; end</tt>
+<tt>while CONDITION; COMMANDS...; end</tt>
\subsection while-synopsis Synopsis
-The <tt>while</tt> builtin causes fish to continually execute the command COMMANDS while the command CONDITION returns with status 0.
+The <tt>while</tt> builtin causes fish to continually execute CONDITION and
+execute COMMANDS as long as CONDITION returned with status 0. If CONDITION is
+false on the first time, COMMANDS will not be executed at all. Hints: use
+<a href="#begin"><tt>begin; ...; end</tt></a> for complex conditions; more
+complex control can be achieved with <tt>while true</tt> containing a
+<a href="#break">break</a>.
\subsection while-example Example
<tt>while test -f foo.txt; echo file exists; sleep 10; end</tt>
-causes fish to print the line 'file exists' at 10 second intervals as long as the file foo.txt exists.
+causes fish to print the line 'file exists' at 10 second intervals as long as
+the file foo.txt exists.