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