1title_text 2---------- 3 4Command ``some_cmd()`` explicit cmake domain. 5Command ``some_cmd()`` without target. 6Command ``some_cmd`` with target. 7Command ``some_cmd_<cmd>()`` placeholder without target. 8Command ``some_cmd_<cmd>`` placeholder with target. 9Command ``some_cmd()`` with parens. 10Command ``some_cmd(SUB)`` with subcommand. 11Command ``some_cmd(SUB)`` with subcommand and target. 12Command ``some_cmd (SUB)`` with space and subcommand and target. 13Command ``some command`` with space and target. 14Variable ``some variable`` space and target. 15Variable ``<PLACEHOLDER>_VARIABLE`` with leading placeholder. 16Variable ``VARIABLE_<PLACEHOLDER>`` with trailing placeholder. 17Variable ``<PLACEHOLDER>_VARIABLE`` with leading placeholder and target. 18Variable ``VARIABLE_<PLACEHOLDER>`` with trailing placeholder and target. 19Environment variable ``SOME_ENV_VAR``. 20Environment variable ``some env var`` with space and target. 21Generator ``Some Generator`` with space. 22Generator ``Some Generator`` with space. 23Generator expression ``SOME_GENEX``. 24Generator expression ``$<SOME_GENEX>`` with brackets. 25Generator expression ``$<SOME_GENEX:...>`` with brackets and parameter. 26Generator expression ``some genex`` with space and target. 27Generator expression ``$<SOME_GENEX>`` with brackets, space, and target. 28Generator expression ``$<SOME_GENEX:...>`` with brackets, parameter, space, and target. 29Inline literal ``~!@#$%^&*( )_+-=\\[]{}'":;,<>.?/``. 30Inline link Link Text. 31Inline link Link Text <With \-escaped Brackets>. 32Inline literal ``__`` followed by inline link Link Text. 33 34First TOC entry. 35 36|not replaced| 37Second TOC entry. 38 39CMake Module Content 40 41More CMake Module Content 42 43Bracket Comment Content 44 45[ 46Bracket Comment Content 47] 48 49.. cmake:command:: some_cmd 50 51 Command some_cmd description. 52 53.. command:: other_cmd 54 55 Command other_cmd description. 56 57.. cmake:envvar:: some_var 58 59 Environment variable some_var description. 60 61.. envvar:: other_var 62 63 Environment variable other_var description. 64 65.. cmake:genex:: SOME_GENEX 66 67 Generator expression SOME_GENEX description. 68 69.. genex:: $<OTHER_GENEX> 70 71 Generator expression $<OTHER_GENEX> description. 72 73.. cmake:variable:: some_var 74 75 Variable some_var description. 76 77.. variable:: other_var 78 79 Variable other_var description. 80 81 Parsed-literal included without directive. 82 Common Indentation Removed 83 # replaced in parsed literal 84 85 # Sample CMake code block 86 if(condition) 87 message(indented) 88 endif() 89 # |not replaced in literal| 90 91A literal block starts after a line consisting of two colons 92 93:: 94 95 Literal block. 96 Common Indentation Removed 97 # |not replaced in literal| 98 99or after a paragraph ending in two colons:: 100 101 Literal block. 102 Common Indentation Removed 103 # |not replaced in literal| 104 105but not after a line ending in two colons:: 106in the middle of a paragraph. 107 108A literal block can be empty:: 109 110 111 112.. productionlist:: 113 grammar: `production` 114 production: "content rendered" 115 116.. note:: 117 Notes are called out. 118 119.. versionadded:: 1.2 120 Version blocks are preserved. 121 122.. versionchanged:: 2.3 123 Version blocks are preserved. 124 125substituted text with multiple lines becomes one line 126 127End of first include. 128 129Cross-include substitution text with ``some_cmd()`` reference. 130 131End of second include. 132