diff options
Diffstat (limited to 'Help')
| -rw-r--r-- | Help/manual/cmake-properties.7.rst | 2 | ||||
| -rw-r--r-- | Help/manual/cmake-variables.7.rst | 2 | ||||
| -rw-r--r-- | Help/manual/cmake.1.rst | 5 | ||||
| -rw-r--r-- | Help/prop_tgt/VERIFY_HEADER_SETS.rst | 25 | ||||
| -rw-r--r-- | Help/prop_tgt/VERIFY_INTERFACE_HEADER_SETS.rst | 25 | ||||
| -rw-r--r-- | Help/release/dev/FindGLUT-remove-undocumented-vars.rst | 5 | ||||
| -rw-r--r-- | Help/release/dev/verify-header-sets.rst | 7 | ||||
| -rw-r--r-- | Help/release/dev/verify-interface-header-sets.rst | 9 | ||||
| -rw-r--r-- | Help/release/dev/werror-property.rst | 5 | ||||
| -rw-r--r-- | Help/variable/CMAKE_VERIFY_INTERFACE_HEADER_SETS.rst (renamed from Help/variable/CMAKE_VERIFY_HEADER_SETS.rst) | 10 |
10 files changed, 56 insertions, 39 deletions
diff --git a/Help/manual/cmake-properties.7.rst b/Help/manual/cmake-properties.7.rst index 20b62c5..7935ca3 100644 --- a/Help/manual/cmake-properties.7.rst +++ b/Help/manual/cmake-properties.7.rst @@ -381,7 +381,7 @@ Properties on Targets /prop_tgt/UNITY_BUILD_CODE_BEFORE_INCLUDE /prop_tgt/UNITY_BUILD_MODE /prop_tgt/UNITY_BUILD_UNIQUE_ID - /prop_tgt/VERIFY_HEADER_SETS + /prop_tgt/VERIFY_INTERFACE_HEADER_SETS /prop_tgt/VERSION /prop_tgt/VISIBILITY_INLINES_HIDDEN /prop_tgt/VS_CONFIGURATION_TYPE diff --git a/Help/manual/cmake-variables.7.rst b/Help/manual/cmake-variables.7.rst index ff431ad..9fbb146 100644 --- a/Help/manual/cmake-variables.7.rst +++ b/Help/manual/cmake-variables.7.rst @@ -510,7 +510,7 @@ Variables that Control the Build /variable/CMAKE_UNITY_BUILD_BATCH_SIZE /variable/CMAKE_UNITY_BUILD_UNIQUE_ID /variable/CMAKE_USE_RELATIVE_PATHS - /variable/CMAKE_VERIFY_HEADER_SETS + /variable/CMAKE_VERIFY_INTERFACE_HEADER_SETS /variable/CMAKE_VISIBILITY_INLINES_HIDDEN /variable/CMAKE_VS_GLOBALS /variable/CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD diff --git a/Help/manual/cmake.1.rst b/Help/manual/cmake.1.rst index e0cb708..38105dd 100644 --- a/Help/manual/cmake.1.rst +++ b/Help/manual/cmake.1.rst @@ -426,6 +426,11 @@ Options in :variable:`CMAKE_SOURCE_DIR` and :variable:`CMAKE_BINARY_DIR`. This flag tells CMake to warn about other files as well. +``--compile-no-warning-as-error`` + Ignore target property :prop_tgt:`COMPILE_WARNING_AS_ERROR` and variable + :variable:`CMAKE_COMPILE_WARNING_AS_ERROR`, preventing warnings from being + treated as errors on compile. + ``--profiling-output=<path>`` Used in conjunction with ``--profiling-format`` to output to a given path. diff --git a/Help/prop_tgt/VERIFY_HEADER_SETS.rst b/Help/prop_tgt/VERIFY_HEADER_SETS.rst deleted file mode 100644 index e151017..0000000 --- a/Help/prop_tgt/VERIFY_HEADER_SETS.rst +++ /dev/null @@ -1,25 +0,0 @@ -VERIFY_HEADER_SETS ------------------- - -.. versionadded:: 3.24 - -Used to verify that all headers in a target's header sets can be included on -their own. - -When this property is set to true, and the target is an object library, static -library, shared library, or executable with exports enabled, and the target -has one or more ``PUBLIC`` or ``INTERFACE`` header sets, an object library -target named ``<target_name>_verify_header_sets`` is created. This verification -target has one source file per header in the ``PUBLIC`` and ``INTERFACE`` -header sets. Each source file only includes its associated header file. The -verification target links against the original target to get all of its usage -requirements. The verification target has its :prop_tgt:`EXCLUDE_FROM_ALL` and -:prop_tgt:`DISABLE_PRECOMPILE_HEADERS` properties set to true, and its -:prop_tgt:`AUTOMOC`, :prop_tgt:`AUTORCC`, :prop_tgt:`AUTOUIC`, and -:prop_tgt:`UNITY_BUILD` properties set to false. - -If the header's :prop_sf:`LANGUAGE` property is set, the value of that property -is used to determine the language with which to compile the header file. -Otherwise, if the target has any C++ sources, the header is compiled as C++. -Otherwise, if the target has any C sources, the header is compiled as C. -Otherwise, the header file is not compiled. diff --git a/Help/prop_tgt/VERIFY_INTERFACE_HEADER_SETS.rst b/Help/prop_tgt/VERIFY_INTERFACE_HEADER_SETS.rst new file mode 100644 index 0000000..d8045c6 --- /dev/null +++ b/Help/prop_tgt/VERIFY_INTERFACE_HEADER_SETS.rst @@ -0,0 +1,25 @@ +VERIFY_INTERFACE_HEADER_SETS +---------------------------- + +.. versionadded:: 3.24 + +Used to verify that all headers in a target's ``PUBLIC`` and ``INTERFACE`` +header sets can be included on their own. + +When this property is set to true, and the target is an object library, static +library, shared library, or executable with exports enabled, and the target +has one or more ``PUBLIC`` or ``INTERFACE`` header sets, an object library +target named ``<target_name>_verify_interface_header_sets`` is created. This +verification target has one source file per header in the ``PUBLIC`` and +``INTERFACE`` header sets. Each source file only includes its associated +header file. The verification target links against the original target to get +all of its usage requirements. The verification target has its +:prop_tgt:`EXCLUDE_FROM_ALL` and :prop_tgt:`DISABLE_PRECOMPILE_HEADERS` +properties set to true, and its :prop_tgt:`AUTOMOC`, :prop_tgt:`AUTORCC`, +:prop_tgt:`AUTOUIC`, and :prop_tgt:`UNITY_BUILD` properties set to false. + +If the header's :prop_sf:`LANGUAGE` property is set, the value of that property +is used to determine the language with which to compile the header file. +Otherwise, if the target has any C++ sources, the header is compiled as C++. +Otherwise, if the target has any C sources, the header is compiled as C. +Otherwise, the header file is not compiled. diff --git a/Help/release/dev/FindGLUT-remove-undocumented-vars.rst b/Help/release/dev/FindGLUT-remove-undocumented-vars.rst new file mode 100644 index 0000000..6a0c904 --- /dev/null +++ b/Help/release/dev/FindGLUT-remove-undocumented-vars.rst @@ -0,0 +1,5 @@ +FindGLUT-remove-undocumented-vars +--------------------------------- + +* The :module:`FindGLUT` module no longer provides the undocumented + result variables ``GLUT_LIBRARY`` and ``GLUT_INCLUDE_PATH``. diff --git a/Help/release/dev/verify-header-sets.rst b/Help/release/dev/verify-header-sets.rst deleted file mode 100644 index 7676382..0000000 --- a/Help/release/dev/verify-header-sets.rst +++ /dev/null @@ -1,7 +0,0 @@ -verify-header-sets ------------------- - -* A new :prop_tgt:`VERIFY_HEADER_SETS` target property was added, which can be - used to verify that all headers in header sets can be used on their own. -* A new :variable:`CMAKE_VERIFY_HEADER_SETS` variable was added, which is used - to initialize the :prop_tgt:`VERIFY_HEADER_SETS` target property. diff --git a/Help/release/dev/verify-interface-header-sets.rst b/Help/release/dev/verify-interface-header-sets.rst new file mode 100644 index 0000000..fcccb62 --- /dev/null +++ b/Help/release/dev/verify-interface-header-sets.rst @@ -0,0 +1,9 @@ +verify-interface-header-sets +---------------------------- + +* A new :prop_tgt:`VERIFY_INTERFACE_HEADER_SETS` target property was added, + which can be used to verify that all headers in header sets can be used on + their own. +* A new :variable:`CMAKE_VERIFY_INTERFACE_HEADER_SETS` variable was added, + which is used to initialize the :prop_tgt:`VERIFY_INTERFACE_HEADER_SETS` + target property. diff --git a/Help/release/dev/werror-property.rst b/Help/release/dev/werror-property.rst index c337df7..84c825f 100644 --- a/Help/release/dev/werror-property.rst +++ b/Help/release/dev/werror-property.rst @@ -6,3 +6,8 @@ werror-property Target Property. If :prop_tgt:`COMPILE_WARNING_AS_ERROR` is true, it expands to a different flag depending on the compiler such that any warnings at compile will be treated as errors. + +* :manual:`cmake(1)` gained the command-line option + ``--compile-no-warning-as-error`` which causes the values of + the :prop_tgt:`COMPILE_WARNING_AS_ERROR` target property and + :variable:`CMAKE_COMPILE_WARNING_AS_ERROR` variable to be ignored. diff --git a/Help/variable/CMAKE_VERIFY_HEADER_SETS.rst b/Help/variable/CMAKE_VERIFY_INTERFACE_HEADER_SETS.rst index 8bd618a..6f14e6f 100644 --- a/Help/variable/CMAKE_VERIFY_HEADER_SETS.rst +++ b/Help/variable/CMAKE_VERIFY_INTERFACE_HEADER_SETS.rst @@ -1,11 +1,11 @@ -CMAKE_VERIFY_HEADER_SETS ------------------------- +CMAKE_VERIFY_INTERFACE_HEADER_SETS +---------------------------------- .. versionadded:: 3.24 -This variable is used to initialize the :prop_tgt:`VERIFY_HEADER_SETS` -property of targets when they are created. Setting it to true -enables header set verification. +This variable is used to initialize the +:prop_tgt:`VERIFY_INTERFACE_HEADER_SETS` property of targets when they are +created. Setting it to true enables header set verification. Projects should not set this variable, it is intended as a developer control to be set on the :manual:`cmake(1)` command line or other |