diff options
| author | Brad King <brad.king@kitware.com> | 2022-07-05 21:30:58 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2022-07-05 21:31:05 (GMT) |
| commit | b90757a13a06a44db49e5b1e62467e15a1e5a8d6 (patch) | |
| tree | 1caff955503d59c168ef1617da7c6f8d7a7f8ab1 | |
| parent | 8fd68f9dd34fb3a151d51eaf833433fd3002d0f9 (diff) | |
| parent | ee6b4294987ff2fd203f8191792ac5f3b701fd4e (diff) | |
| download | CMake-b90757a13a06a44db49e5b1e62467e15a1e5a8d6.zip CMake-b90757a13a06a44db49e5b1e62467e15a1e5a8d6.tar.gz CMake-b90757a13a06a44db49e5b1e62467e15a1e5a8d6.tar.bz2 | |
Merge topic 'docopt' into release-3.24
ee6b429498 Help: Clarify that option() is a boolean
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7434
| -rw-r--r-- | Help/command/option.rst | 10 |
1 files changed, 6 insertions, 4 deletions
diff --git a/Help/command/option.rst b/Help/command/option.rst index 02b8dac..464ad44 100644 --- a/Help/command/option.rst +++ b/Help/command/option.rst @@ -1,16 +1,18 @@ option ------ -Provide an option that the user can optionally select. +Provide a boolean option that the user can optionally select. .. code-block:: cmake option(<variable> "<help_text>" [value]) -Provides an option for the user to select as ``ON`` or ``OFF``. -If no initial ``<value>`` is provided, ``OFF`` is used. +If no initial ``<value>`` is provided, boolean ``OFF`` is the default value. If ``<variable>`` is already set as a normal or cache variable, then the command does nothing (see policy :policy:`CMP0077`). -If you have options that depend on the values of other options, see +For options that depend on the values of other options, see the module help for :module:`CMakeDependentOption`. + +In CMake project mode, a boolean cache variable is created with the option +value. In CMake script mode, a boolean variable is set with the option value. |