| option | |
| ------ | |
| Provide a boolean option that the user can optionally select. | |
| .. code-block:: cmake | |
| option(<variable> "<help_text>" [value]) | |
| 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`). | |
| 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. | |
| See Also | |
| ^^^^^^^^ | |
| * The :module:`CMakeDependentOption` module to specify boolean options that | |
| depend on the values of other options or a set of conditions. |