summaryrefslogtreecommitdiffstats
path: root/Help/manual/OPTIONS_HELP.txt
blob: f4f2dbe88a456bfa75c778a0bed6285558c32036 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
.. |file| replace:: The output is printed to a named ``<file>`` if given.

.. option:: -version [<file>], --version [<file>], /V [<file>]

 Show program name/version banner and exit.
 |file|

.. option:: -h, -H, --help, -help, -usage, /?

 Print usage information and exit.

 Usage describes the basic command line interface and its options.

.. option:: --help <keyword> [<file>]

 Print help for one CMake keyword.

 ``<keyword>`` can be a property, variable, command, policy, generator
 or module.

 The relevant manual entry for ``<keyword>`` is
 printed in a human-readable text format.
 |file|

 .. versionchanged:: 3.28

   Prior to CMake 3.28, this option supported command names only.

.. option:: --help-full [<file>]

 Print all help manuals and exit.

 All manuals are printed in a human-readable text format.
 |file|

.. option:: --help-manual <man> [<file>]

 Print one help manual and exit.

 The specified manual is printed in a human-readable text format.
 |file|

.. option:: --help-manual-list [<file>]

 List help manuals available and exit.

 The list contains all manuals for which help may be obtained by
 using the ``--help-manual`` option followed by a manual name.
 |file|

.. option:: --help-command <cmd> [<file>]

 Print help for one command and exit.

 The :manual:`cmake-commands(7)` manual entry for ``<cmd>`` is
 printed in a human-readable text format.
 |file|

.. option:: --help-command-list [<file>]

 List commands with help available and exit.

 The list contains all commands for which help may be obtained by
 using the ``--help-command`` option followed by a command name.
 |file|

.. option:: --help-commands [<file>]

 Print cmake-commands manual and exit.

 The :manual:`cmake-commands(7)` manual is printed in a
 human-readable text format.
 |file|

.. option:: --help-module <mod> [<file>]

 Print help for one module and exit.

 The :manual:`cmake-modules(7)` manual entry for ``<mod>`` is printed
 in a human-readable text format.
 |file|

.. option:: --help-module-list [<file>]

 List modules with help available and exit.

 The list contains all modules for which help may be obtained by
 using the ``--help-module`` option followed by a module name.
 |file|

.. option:: --help-modules [<file>]

 Print cmake-modules manual and exit.

 The :manual:`cmake-modules(7)` manual is printed in a human-readable
 text format.
 |file|

.. option:: --help-policy <cmp> [<file>]

 Print help for one policy and exit.

 The :manual:`cmake-policies(7)` manual entry for ``<cmp>`` is
 printed in a human-readable text format.
 |file|

.. option:: --help-policy-list [<file>]

 List policies with help available and exit.

 The list contains all policies for which help may be obtained by
 using the ``--help-policy`` option followed by a policy name.
 |file|

.. option:: --help-policies [<file>]

 Print cmake-policies manual and exit.

 The :manual:`cmake-policies(7)` manual is printed in a
 human-readable text format.
 |file|

.. option:: --help-property <prop> [<file>]

 Print help for one property and exit.

 The :manual:`cmake-properties(7)` manual entries for ``<prop>`` are
 printed in a human-readable text format.
 |file|

.. option:: --help-property-list [<file>]

 List properties with help available and exit.

 The list contains all properties for which help may be obtained by
 using the ``--help-property`` option followed by a property name.
 |file|

.. option:: --help-properties [<file>]

 Print cmake-properties manual and exit.

 The :manual:`cmake-properties(7)` manual is printed in a
 human-readable text format.
 |file|

.. option:: --help-variable <var> [<file>]

 Print help for one variable and exit.

 The :manual:`cmake-variables(7)` manual entry for ``<var>`` is
 printed in a human-readable text format.
 |file|

.. option:: --help-variable-list [<file>]

 List variables with help available and exit.

 The list contains all variables for which help may be obtained by
 using the ``--help-variable`` option followed by a variable name.
 |file|

.. option:: --help-variables [<file>]

 Print cmake-variables manual and exit.

 The :manual:`cmake-variables(7)` manual is printed in a
 human-readable text format.
 |file|