mirror of
https://github.com/reactos/CMake.git
synced 2024-11-24 12:09:48 +00:00
c2efb3efcd
Revise docs for all "Scripting Commands", except four find_XXX that use a macro suite of their own. * Take full advantage of the improved syntax highlighting. * Make consequential use of <..> placeholders. * Clarify things here and there in the text. Specific improvements to some command docs: * "math": Correct description of novel hexadecimal capability. * "if", "foreach", "while": Provide link to "endif" etc * "foreach", "while": Mention "break" and "continue". * "foreach": Simplify explanation of ``RANGE`` and ``IN`` signatures; advise against negative arguments or reverse ranges (compare issue #18461) * "endif", "endfunction" etc: Explain that the argument is optional and maintained for compatibility only
26 lines
787 B
ReStructuredText
26 lines
787 B
ReStructuredText
while
|
|
-----
|
|
|
|
Evaluate a group of commands while a condition is true
|
|
|
|
.. code-block:: cmake
|
|
|
|
while(<condition>)
|
|
<commands>
|
|
endwhile()
|
|
|
|
All commands between while and the matching :command:`endwhile` are recorded
|
|
without being invoked. Once the :command:`endwhile` is evaluated, the
|
|
recorded list of commands is invoked as long as the ``<condition>`` is true.
|
|
|
|
The ``<condition>`` has the same syntax and is evaluated using the same logic
|
|
as described at length for the :command:`if` command.
|
|
|
|
The commands :command:`break` and :command:`continue` provide means to
|
|
escape from the normal control flow.
|
|
|
|
Per legacy, the :command:`endwhile` command admits
|
|
an optional ``<condition>`` argument.
|
|
If used, it must be a verbatim repeat of the argument of the opening
|
|
``while`` command.
|