Run the `Utilities/Sphinx/update_versions.py` script to add initial markup to every top-level document and find module. Issue: #19715
@@ -1,6 +1,8 @@
add_compile_definitions
-----------------------
+.. versionadded:: 3.12
+
Add preprocessor definitions to the compilation of source files.
.. code-block:: cmake
add_link_options
----------------
+.. versionadded:: 3.13
Add options to the link step for executable, shared library or module
library targets in the current directory and below that are added after
this command is invoked.
cmake_language
--------------
+.. versionadded:: 3.18
Call meta-operations on CMake commands.
Synopsis
cmake_parse_arguments
---------------------
+.. versionadded:: 3.5
Parse function or macro arguments.
continue
--------
+.. versionadded:: 3.2
Continue to the top of enclosing foreach or while loop.
include_guard
-------------
+.. versionadded:: 3.10
Provides an include guard for the file currently being processed by CMake.
target_compile_features
+.. versionadded:: 3.1
Add expected compiler features to a target.
target_link_directories
Add link directories to a target.
target_link_options
-------------------
Add options to the link step for an executable, shared library or module
library target.
target_precompile_headers
-------------------------
+.. versionadded:: 3.16
Add a list of header files to precompile.
Precompiling header files can speed up compilation by creating a partially
target_sources
Add sources to a target.
ASM<DIALECT>
------------
.. include:: ENV_VAR.txt
Preferred executable for compiling a specific dialect of assembly language
ASM<DIALECT>FLAGS
-----------------
Default compilation flags to be used when compiling a specific dialect of an
CC
--
Preferred executable for compiling ``C`` language files. Will only be used by
CCMAKE_COLORS
Determines what colors are used by the CMake curses interface,
when run on a terminal that supports colors.
The syntax follows the same conventions as ``LS_COLORS``;
CFLAGS
------
Default compilation flags to be used when compiling ``C`` files. Will only be
CMAKE_BUILD_PARALLEL_LEVEL
--------------------------
Specifies the maximum number of concurrent processes to use when building
CMAKE_CONFIG_TYPE
The default build configuration for :ref:`Build Tool Mode` and
CMAKE_EXPORT_COMPILE_COMMANDS
-----------------------------
+.. versionadded:: 3.17
The default value for :variable:`CMAKE_EXPORT_COMPILE_COMMANDS` when there
CMAKE_GENERATOR
---------------
+.. versionadded:: 3.15
Specifies the CMake default generator to use when no generator is supplied
CMAKE_GENERATOR_INSTANCE
------------------------
Default value for :variable:`CMAKE_GENERATOR_INSTANCE` if no Cache entry is
CMAKE_GENERATOR_PLATFORM
Default value for :variable:`CMAKE_GENERATOR_PLATFORM` if no Cache entry
CMAKE_GENERATOR_TOOLSET
Default value for :variable:`CMAKE_GENERATOR_TOOLSET` if no Cache entry
CMAKE_<LANG>_COMPILER_LAUNCHER
------------------------------
Default compiler launcher to use for the specified language. Will only be used
CMAKE_MSVCIDE_RUN_PATH
----------------------
Extra PATH locations for custom commands when using
CMAKE_NO_VERBOSE
+.. versionadded:: 3.14
Disables verbose output from CMake when :envvar:`VERBOSE` environment variable
is set.
CMAKE_OSX_ARCHITECTURES
Target specific architectures for macOS.
CMAKE_PREFIX_PATH
The ``CMAKE_PREFIX_PATH`` environment variable may be set to a list of
CSFLAGS
-------
Preferred executable for compiling ``CSharp`` language files. Will only be
CTEST_INTERACTIVE_DEBUG_MODE
----------------------------
Environment variable that will exist and be set to ``1`` when a test executed
CTEST_OUTPUT_ON_FAILURE
Boolean environment variable that controls if the output should be logged for
CTEST_PARALLEL_LEVEL
--------------------
Specify the number of tests for CTest to run in parallel. See :manual:`ctest(1)`
CTEST_PROGRESS_OUTPUT
Boolean environment variable that affects how :manual:`ctest <ctest(1)>`
CTEST_USE_LAUNCHERS_DEFAULT
---------------------------
Initializes the :variable:`CTEST_USE_LAUNCHERS` variable if not already defined.
CUDACXX
Preferred executable for compiling ``CUDA`` language files. Will only be used by
CUDAFLAGS
---------
Default compilation flags to be used when compiling ``CUDA`` files. Will only be
CUDAHOSTCXX
-----------
Preferred executable for compiling host code when compiling ``CUDA``
CXX
---
Preferred executable for compiling ``CXX`` language files. Will only be used by
CXXFLAGS
Default compilation flags to be used when compiling ``CXX`` (C++) files. Will
DASHBOARD_TEST_FROM_CTEST
Environment variable that will exist when a test executed by :manual:`ctest(1)`
DESTDIR
On UNIX one can use the ``DESTDIR`` mechanism in order to relocate the
FC
Preferred executable for compiling ``Fortran`` language files. Will only be used
FFLAGS
Default compilation flags to be used when compiling ``Fortran`` files. Will only
LDFLAGS
Will only be used by CMake on the first configuration to determine the default
MACOSX_DEPLOYMENT_TARGET
Specify the minimum version of macOS on which the target binaries are
OBJC
----
+.. versionadded:: 3.16.7
Preferred executable for compiling ``OBJC`` language files. Will only be used
OBJCXX
Preferred executable for compiling ``OBJCXX`` language files. Will only be used
<PackageName>_ROOT
------------------
+.. versionadded:: 3.12.1
Calls to :command:`find_package(<PackageName>)` will search in prefixes
RC
Preferred executable for compiling ``resource`` files. Will only be used by CMake
RCFLAGS
Default compilation flags to be used when compiling ``resource`` files. Will
SWIFTC
Preferred executable for compiling ``Swift`` language files. Will only be used by
VERBOSE
Activates verbose output from CMake and your build tools of choice when
you start to actually build your project.
Green Hills MULTI
+.. versionadded:: 3.3
Generates Green Hills MULTI project files (experimental, work-in-progress).
The buildsystem has predetermined build-configuration settings that can be controlled
Ninja Multi-Config
Generates multiple ``build-<Config>.ninja`` files.
This generator is very much like the :generator:`Ninja` generator, but with
Visual Studio 14 2015
Generates Visual Studio 14 (VS 2015) project files.
Project Types
Visual Studio 15 2017
+.. versionadded:: 3.7.1
Generates Visual Studio 15 (VS 2017) project files.
Visual Studio 16 2019
Generates Visual Studio 16 (VS 2019) project files.
@@ -1,4 +1,6 @@
CPackArchive
+.. versionadded:: 3.9
The documentation for the CPack Archive generator has moved here: :cpack_gen:`CPack Archive Generator`
CPackFreeBSD
The documentation for the CPack FreeBSD generator has moved here: :cpack_gen:`CPack FreeBSD Generator`
CPackNuGet
----------
The documentation for the CPack NuGet generator has moved here: :cpack_gen:`CPack NuGet Generator`
CPackProductBuild
+.. versionadded:: 3.7
The documentation for the CPack productbuild generator has moved here: :cpack_gen:`CPack productbuild Generator`
CMP0051
List TARGET_OBJECTS in SOURCES target property.
CMake 3.0 and lower did not include the ``TARGET_OBJECTS``
CMP0052
Reject source and build dirs in installed
:prop_tgt:`INTERFACE_INCLUDE_DIRECTORIES`.
CMP0053
Simplify variable reference and escape sequence evaluation.
CMake 3.1 introduced a much faster implementation of evaluation of the
CMP0054
Only interpret :command:`if` arguments as variables or keywords when unquoted.
CMake 3.1 and above no longer implicitly dereference variables or
CMP0055
Strict checking for the :command:`break` command.
CMake 3.1 and lower allowed calls to the :command:`break` command
CMP0056
Honor link flags in :command:`try_compile` source-file signature.
The :command:`try_compile` command source-file signature generates a
CMP0057
Support new :command:`if` IN_LIST operator.
CMake 3.3 adds support for the new IN_LIST operator.
CMP0058
Ninja requires custom command byproducts to be explicit.
When an intermediate file generated during the build is consumed
CMP0059
Do not treat ``DEFINITIONS`` as a built-in directory property.
CMake 3.3 and above no longer make a list of definitions available through
CMP0060
Link libraries by full path even in implicit directories.
Policy :policy:`CMP0003` was introduced with the intention of always
CMP0061
CTest does not by default tell ``make`` to ignore errors (``-i``).
The :command:`ctest_build` and :command:`build_command` commands no
CMP0062
Disallow :command:`install` of :command:`export` result.
The :command:`export()` command generates a file containing
CMP0063
Honor visibility properties for all target types.
The :prop_tgt:`<LANG>_VISIBILITY_PRESET` and
CMP0064
+.. versionadded:: 3.4
Recognize ``TEST`` as a operator for the :command:`if` command.
The ``TEST`` operator was added to the :command:`if` command to determine if a
CMP0065
Do not add flags to export symbols from executables without
the :prop_tgt:`ENABLE_EXPORTS` target property.
CMP0066
Honor per-config flags in :command:`try_compile` source-file signature.
The source file signature of the :command:`try_compile` command uses the value
CMP0067
+.. versionadded:: 3.8
Honor language standard in :command:`try_compile` source-file signature.
The :command:`try_compile` source file signature is intended to allow
CMP0068
``RPATH`` settings on macOS do not affect ``install_name``.
CMake 3.9 and newer remove any effect the following settings may have on the
CMP0069
:prop_tgt:`INTERPROCEDURAL_OPTIMIZATION` is enforced when enabled.
CMake 3.9 and newer prefer to add IPO flags whenever the
CMP0070
Define :command:`file(GENERATE)` behavior for relative paths.
CMake 3.10 and newer define that relative paths given to ``INPUT`` and
CMP0071
Let :prop_tgt:`AUTOMOC` and :prop_tgt:`AUTOUIC` process
:prop_sf:`GENERATED` files.
CMP0072
+.. versionadded:: 3.11
:module:`FindOpenGL` prefers GLVND by default when available.
The :module:`FindOpenGL` module provides an ``OpenGL::GL`` target and an
CMP0073
Do not produce legacy ``_LIB_DEPENDS`` cache entries.
Ancient CMake versions once used ``<tgt>_LIB_DEPENDS`` cache entries to
CMP0074
:command:`find_package` uses ``<PackageName>_ROOT`` variables.
In CMake 3.12 and above the :command:`find_package(<PackageName>)` command now
CMP0075
Include file check macros honor ``CMAKE_REQUIRED_LIBRARIES``.
In CMake 3.12 and above, the
CMP0076
The :command:`target_sources` command converts relative paths to absolute.
In CMake 3.13 and above, the :command:`target_sources` command now converts
CMP0077
:command:`option` honors normal variables.
The :command:`option` command is typically used to create a cache entry
CMP0078
:module:`UseSWIG` generates standard target names.
Starting with CMake 3.13, :module:`UseSWIG` generates now standard target
CMP0079
:command:`target_link_libraries` allows use with targets in other directories.
Prior to CMake 3.13 the :command:`target_link_libraries` command did not
CMP0080
:module:`BundleUtilities` cannot be included at configure time.
The macros provided by :module:`BundleUtilities` are intended to be invoked
CMP0081
Relative paths not allowed in :prop_tgt:`LINK_DIRECTORIES` target property.
CMake 3.12 and lower allowed the :prop_dir:`LINK_DIRECTORIES` directory
CMP0082
Install rules from :command:`add_subdirectory` calls are interleaved with
those in caller.
CMP0083
To control generation of Position Independent Executable (``PIE``) or not, some
flags are required at link time.
CMP0084
The :module:`FindQt` module does not exist for :command:`find_package`.
The existence of :module:`FindQt` means that for Qt upstream to provide
CMP0085
``$<IN_LIST:...>`` handles empty list items.
In CMake 3.13 and lower, the ``$<IN_LIST:...>`` generator expression always
CMP0086
:module:`UseSWIG` honors ``SWIG_MODULE_NAME`` via ``-module`` flag.
Starting with CMake 3.14, :module:`UseSWIG` passes option
CMP0087
:command:`install(CODE)` and :command:`install(SCRIPT)` support generator
expressions.
CMP0088
:module:`FindBISON` runs bison in :variable:`CMAKE_CURRENT_BINARY_DIR`
when executing.
CMP0089
Compiler id for IBM Clang-based XL compilers is now ``XLClang``.
CMake 3.15 and above recognize that IBM's Clang-based XL compilers