| CMake Experimental Features Guide | |
| ********************************* | |
| The following is a guide to CMake experimental features that are | |
| under development and not yet included in official documentation. | |
| See documentation on `CMake Development`_ for more information. | |
| .. _`CMake Development`: README.rst | |
| Features are gated behind ``CMAKE_EXPERIMENTAL_`` variables which must be set | |
| to specific values in order to enable their gated behaviors. Note that the | |
| specific values will change over time to reinforce their experimental nature. | |
| When used, a warning will be generated to indicate that an experimental | |
| feature is in use and that the affected behavior in the project is not part of | |
| CMake's stability guarantees. |