fish-shell/doc_src/while.txt

\section while while - perform a command multiple times

\subsection while-synopsis Synopsis
\fish{synopsis}
while CONDITION; COMMANDS...; end
\endfish

\subsection while-description Description

`while` repeatedly executes `CONDITION`, and if the exit status is 0, then executes `COMMANDS`.

If the exit status of `CONDITION` is non-zero on the first iteration, `COMMANDS` will not be executed at all.

You can use <a href="#and">`and`</a> or <a href="#and">`or`</a> for complex conditions. Even more complex control can be achieved with `while true` containing a <a href="#break">break</a>.

\subsection while-example Example

\fish
while test -f foo.txt; or test -f bar.txt ; echo file exists; sleep 10; end
# outputs 'file exists' at 10 second intervals as long as the file foo.txt or bar.txt exists.
\endfish
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00			`\section while while - perform a command multiple times`

			`\subsection while-synopsis Synopsis`
Simplify styling 2014-08-01 12:25:41 +00:00			`\fish{synopsis}`
Documentation update Rework for Doxygen >1.8. Moved large parts of the documentation to a simplified format, making use of Markdown enhancements and fixing bad long options. 2014-08-01 02:37:32 +00:00			`while CONDITION; COMMANDS...; end`
			`\endfish`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00
Fix casing and other minor issues in documentation darcs-hash:20061031152316-ac50b-e68db9853d6e9461a0c054f1ea290704ccfc0a31.gz 2006-10-31 15:23:16 +00:00			`\subsection while-description Description`
Help cleanup Large list of changes, including formatting and typos for most commands. More substantive changes have been made to alias, bind, block, break, builtin, case, cd, commandline, count, else, emit, fish_config, funced, function, functions, history, math, mimedb, nextd, not, popd, prevd, pushd, pwd, random, read, set, set_color, switch, test, trap, type, ulimit, umask, and while. 2013-05-12 07:56:01 +00:00
Make line length, wrapping and spacing consistent 2014-08-19 12:41:23 +00:00			`while` repeatedly executes `CONDITION`, and if the exit status is 0, then executes `COMMANDS`.

			If the exit status of `CONDITION` is non-zero on the first iteration, `COMMANDS` will not be executed at all.

Update docs to reflect new if/while condtion chaining Documents new behavior in #1428 Cherry picked from 30ea7cc3f8a5d56ad30dc749ea374363c15f312a 2016-05-19 20:00:40 +00:00			You can use <a href="#and">`and`</a> or <a href="#and">`or`</a> for complex conditions. Even more complex control can be achieved with `while true` containing a <a href="#break">break</a>.
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00
			`\subsection while-example Example`

Tutorial auto colouring, Man page and Make fixes Completely fixes #1557 and the underlying Doxygen changes that caused it. Should make fish docs simpler and more robust, more consistent and generally prettier. todo: - trap unmarked text as arguments in context - test & fix sed portability - see in particular. (so far tested on BSD (Mac) and GNU sed). - test Makefile changes - last round of aesthetic changes and getting that ascii fish in there… 2014-08-08 02:44:37 +00:00			`\fish`
Update docs to reflect new if/while condtion chaining Documents new behavior in #1428 Cherry picked from 30ea7cc3f8a5d56ad30dc749ea374363c15f312a 2016-05-19 20:00:40 +00:00			`while test -f foo.txt; or test -f bar.txt ; echo file exists; sleep 10; end`
			`# outputs 'file exists' at 10 second intervals as long as the file foo.txt or bar.txt exists.`
			`\endfish`