Skip to content

Help: Revise docs on Scripting Commands

Joachim Wuttke requested to merge jwuttke/cmake:scripting-commands into master

Revise docs for all "Scripting Commands", except four find_XXX commands 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

Merge request reports