summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Tutorial: Restore TODO 4 comment in step 7Brice Decaestecker2024-11-271-0/+1
| | | | | | | Restore a comment added by commit f9ef15f3dc (Tutorial: Update step 7 style, 2022-10-07, v3.26.0-rc1~482^2) that was accidentally removed by commit 8ddf32196c (Tutorial: Refactor MathFunctions code, 2023-02-10, v3.27.0-rc1~441^2).
* AIX: Propagate AIX_SHARED_LIBRARY_ARCHIVE through exportsBrad King2024-11-222-4/+6
| | | | | | | Teach `export()` and `install(EXPORT)` to record this setting on the imported targets they generate. Make this property's non-presence authoritative on imported targets since they represent what was built elsewhere.
* CMake 3.31.1v3.31.1Brad King2024-11-211-0/+12
|
* Merge branch 'release-3.30' into release-3.31Brad King2024-11-211-0/+7
|\
| * CMake 3.30.6v3.30.6Brad King2024-11-211-0/+7
| |
* | Merge branch 'release-3.30' into release-3.31Brad King2024-11-211-2/+2
|\ \ | |/
| * Merge branch 'release-3.29' into release-3.30Brad King2024-11-211-2/+2
| |\
| | * CMake 3.29.9v3.29.9Brad King2024-11-211-2/+2
| | |
| * | Merge topic 'doc-rel-3.29' into release-3.30Brad King2024-10-152-6/+4
| |\ \ | | |/ | | | | | | | | | | | | | | | 0e81c12483 Help: Add 3.29 release note for try_compile LINKER_LANGUAGE option Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9905
* | | CMP0175: Do not reject USES_TERMINAL for add_custom_command(TARGET)Craig Scott2024-11-152-3/+4
| | | | | | | | | | | | Fixes: #26449
* | | Help: Clarify instructions for using older VS toolsets with newer VS versionsBrad King2024-11-144-11/+14
| | | | | | | | | | | | | | | | | | | | | Clarify that the newer version of VS must also be installed to use its corresponding CMake generator. Issue: #26446
* | | Merge topic 'FindSQLite3-pkg-config' into release-3.31Brad King2024-11-121-1/+3
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2d228201fc Help: Guard calls to pkg_check_modules in cmake-developer(7) example 674a987898 FindSQLite3: Guard calls to pkg_check_modules Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9983
| * | | Help: Guard calls to pkg_check_modules in cmake-developer(7) examplePeter Kokot2024-11-111-1/+3
| | | | | | | | | | | | | | | | | | | | This was missed in commit 25b947589a (Modules: Guard calls to pkg_check_modules, 2024-08-07, v3.31.0-rc1~236^2).
* | | | Help: Add missing one-line summary to policy CMP0132Brad King2024-11-111-0/+2
|/ / / | | | | | | | | | | | | This was missed in commit 05e510bf0b (CMP0132: Don't set compiler environment variables on first run, 2022-03-23, v3.24.0-rc1~380^2).
* | | Merge topic 'aix-archive-shared-libraries' into release-3.31Brad King2024-10-291-3/+3
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 4207687a5f Help: Update AIX_SHARED_LIBRARY_ARCHIVE for versioned shared objects Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9954
| * | | Help: Update AIX_SHARED_LIBRARY_ARCHIVE for versioned shared objectsAditya Vidyadhar Kamath2024-10-291-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | This was missed in commit dc8e4f8f0c (AIX: Enable versioned shared objects with CMAKE_AIX_SHARED_LIBRARY_ARCHIVE, 2024-10-10, v3.31.0-rc2~8^2).
* | | | Merge topic 'doc-CMP0174' into release-3.31Brad King2024-10-291-0/+4
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6aa2e22300 Help: Add 3.31 release note for cmake_parse_arguments CMP0174 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9955
| * | | | Help: Add 3.31 release note for cmake_parse_arguments CMP0174Peter Kokot2024-10-281-0/+4
| |/ / / | | | | | | | | | | | | | | | | | | | | This was left out by commit ceeea4e511 (cmake_parse_arguments: Set variable if empty string given after keyword, 2024-08-18, v3.31.0-rc1~175^2).
* | | | cmake_parse_arguments: Restore capture of value after repeated keywordCraig Scott2024-10-281-10/+14
|/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When a single-value keyword is repeated, and the first instance is missing a value, it prevents the value from the second instance from being stored in a variable. This was a regression introduced by commit ceeea4e511 (cmake_parse_arguments: Set variable if empty string given after keyword, 2024-08-18). That change also didn't create a variable if the keyword was given but without a value. The purpose of the change was to always define a variable if a keyword was given. Lastly, that change didn't protect the CMP0174 logic to make it only apply to the PARSE_ARGV form. The first two of the above problems are fixed here by tracking the keywords given instead of checking which keywords were missing values. The third problem is also fixed here, being tightly coupled to the same logic as the first two problems. Fixes: #26397
* | | Merge topic 'link-strategy' into release-3.31Brad King2024-10-281-8/+11
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 39fd396421 LINK_LIBRARIES_STRATEGY: Rename strategies to clarify expectations Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: Craig Scott <craig.scott@crascit.com> Merge-request: !9949
| * | | LINK_LIBRARIES_STRATEGY: Rename strategies to clarify expectationsBrad King2024-10-251-8/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since commit 7abd3137b7 (Linking: Optionally reorder direct dependencies from LINK_LIBRARIES, 2024-09-19, v3.31.0-rc1~53^2) the strategy name `PRESERVE_ORDER` has led users to expect that it strictly preserves order. While the part of the link line generation logic controlled by `LINK_LIBRARIES_STRATEGY` does preserve order, it is not the last step. Toolchain-specific de-duplication can cause the order to change on the actual link line generated in the build system. Rename the strategies: * `PRESERVE_ORDER` => `REORDER_MINIMALLY` * `REORDER` => `REORDER_FREELY` The new names make it clear that reordering is always possible, just to varying degrees. Update the `LINK_LIBRARIES_STRATEGY` documentation to clarify that the strategies do not directly control the final link line. Fixes: #26400 Issue: #26271
* | | | codespell: Fix typosBrad King2024-10-251-1/+1
|/ / /
* | | Merge topic 'Help-CMAKE_LINK_DEPENDS_USE_LINKER' into release-3.31Brad King2024-10-251-2/+3
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 686698a7b4 Help: Update note relative the GNU binutils linkers Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9938
| * | | Help: Update note relative the GNU binutils linkersMarc Chevrier2024-10-241-2/+3
| | | |
* | | | Merge topic 'fix-path-search-doc' into release-3.31Brad King2024-10-242-24/+47
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 630e4a12a3 Help: Fix find_package search order w.r.t. globs Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: Matthew Woehlke <matthew.woehlke@kitware.com> Merge-request: !9930
| * | | | Help: Fix find_package search order w.r.t. globsMatthew Woehlke2024-10-232-24/+47
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add documentation to clarify that `find_package` searches paths in the specified order and stops at the first match. Clarify documentation of `CMAKE_FIND_PACKAGE_SORT_*` to match the actual behavior. Note that no behavior is actually changed, this merely improves the documentation to reflect actual behavior rather than seeming to imply something else. Also, update the test to verify that what we claim in the updated documentation is what's actually happening.
* | | | Help: Clarify LINK_LIBRARIES_STRATEGY follow-up de-duplicationBrad King2024-10-231-10/+26
|/ / / | | | | | | | | | | | | | | | | | | Extend discussion of the ``PRESERVE_ORDER`` example to prominently explain how platform-specific behavior can affect generated link lines. Closes: #26388
* | | Help: Move LINK_LIBRARIES_STRATEGY details to target property docsCraig Scott2024-10-182-63/+63
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | For cases where a CMAKE_XXX variable provides a default value for a XXX target property, the convention used in the documentation is to put the detailed explanation in the target property docs, leaving the variable docs to be fairly minimal and cross-reference the target property docs for details. When the (CMAKE_)LINK_LIBRARIES_STRATEGY docs were first added, they were the opposite of this convention, putting the details in the variable docs instead of the property docs. This change moves the details to the property docs to make it consistent with the prevailing convention used elsewhere.
* | | Merge topic 'doc-rel-3.31' into release-3.31Brad King2024-10-152-5/+3
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 315a8f88cc Help: Add 3.31 release note for file(MAKE_DIRECTORY)'s RESULT option Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9904
| * | | Help: Add 3.31 release note for file(MAKE_DIRECTORY)'s RESULT optionPeter Kokot2024-10-152-5/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In commit 95323c90a1 (file(MAKE_DIRECTORY): Add optional RESULT keyword to capture failure., 2024-06-16, v3.31.0-rc1~414^2) the release note was added in the wrong directory so it was not gathered for the 3.31 release. Fixes: #26377
* | | | Merge topic 'doc-rel-3.29' into release-3.31Brad King2024-10-152-6/+4
|\ \ \ \ | |/ / / |/| | / | | |/ | |/| | | | | | | 0e81c12483 Help: Add 3.29 release note for try_compile LINKER_LANGUAGE option Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9905
| * | Help: Add 3.29 release note for try_compile LINKER_LANGUAGE optionBrad King2024-10-152-6/+4
| | | | | | | | | | | | | | | | | | In commit 0f37000304 (try_{compile,run}: add LINKER_LANGUAGE option, 2023-10-12, v3.29.0-rc1~567^2) a release note was accidentally added in the wrong directory and so was not included in the 3.29 release notes.
* | | Help/dev: Add maintainer guide release branch creation to use a MR for CIBrad King2024-10-091-2/+13
| | | | | | | | | | | | | | | Provide a way to run CI with a new release version number before merging it.
* | | Help: Drop development topic notes to prepare releaseBrad King2024-10-092-9/+0
| | | | | | | | | | | | | | | Release versions do not have the development topic section of the CMake Release Notes index page.
* | | Help: Update Sphinx versionadded directives for 3.31 releaseBrad King2024-10-093-0/+6
| | | | | | | | | | | | | | | | | | Run the script: Utilities/Sphinx/update_versions.py --since v3.30.0 --overwrite
* | | Help: Organize and revise 3.31 release notesBrad King2024-10-091-201/+177
| | | | | | | | | | | | | | | Add section headers similar to the 3.30 release notes and move each individual bullet into an appropriate section. Revise a few bullets.
* | | Help: Consolidate 3.31 release notesBrad King2024-10-0940-344/+277
| | | | | | | | | | | | | | | Run the `Utilities/Release/consolidate-relnotes.bash` script to move notes from `Help/release/dev/*` into `Help/release/3.31.rst`.
* | | project: Always set <PROJECT-NAME>_* as normal variablesCraig Scott2024-10-084-20/+55
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Re-introduce the behavior originally introduced in CMake 3.30.3 by commit c1ece78d11 (project: non cache <project> prefix variables are also created, 2024-08-27, v3.30.3~2^2), but this time with a policy for compatibility. Issue: #25714 Issue: #26243
* | | Merge branch 'release-3.30'Brad King2024-10-081-10/+11
|\ \ \ | | |/ | |/|
| * | CMake 3.30.5v3.30.5Brad King2024-10-081-10/+11
| | |
* | | Merge topic 'FindOpenMP-CUDA-Clang'Brad King2024-10-081-2/+1
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | a4b60d948d FindOpenMP: Add support for CUDA when compiling with Clang Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9886
| * | | FindOpenMP: Add support for CUDA when compiling with ClangBrad King2024-10-071-2/+1
| | | |
* | | | Merge topic 'project-vars'Brad King2024-10-082-7/+39
|\ \ \ \ | |/ / / |/| / / | |/ / | | | | | | | | | | | | fa07ddfebf project: Only check non-cache vars when setting project vars Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !9883
| * | project: Only check non-cache vars when setting project varsCraig Scott2024-10-072-7/+39
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The change in commit 86ad7cc886 (project: Only define non-cache vars if already defined, 2024-09-15, v3.30.4~2^2) was meant to only check for non-cache variables when deciding whether to set non-cache project variables for the current call. However, it erroneously checked for any variable, including cache variables. This gives the intended result on the first run, but on subsequent runs a cache variable will exist that did not on the first run, leading to different behavior between the two runs. Fix the logic to only check for a pre-existing non-cache variable, as was originally intended. Fixes: #26355
* | | Merge topic 'cmake--workflow-preset'Brad King2024-10-072-2/+17
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | b80aa1d3a3 preset: Easier command line interface for Workflow Presets Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: scivision <michael@scivision.dev> Merge-request: !9866
| * | | preset: Easier command line interface for Workflow PresetsKevin Tolle2024-10-052-2/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | A positional option allows 'cmake --workflow --preset <preset>' to be shortened to 'cmake --workflow <preset>'. Fixes: #26270
* | | | Merge topic 'GoogleTest-DISCOVERY_EXTRA_ARGS'Brad King2024-10-071-0/+6
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | 2dcba446e2 GoogleTest: Add DISCOVERY_EXTRA_ARGS to gtest_discover_tests() f55f9fd5c1 Help: Mention TEST_LIST with gtest_discover_tests() can omit tests Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !9856
| * | | GoogleTest: Add DISCOVERY_EXTRA_ARGS to gtest_discover_tests()Cedric Martineau2024-10-041-0/+6
| | | | | | | | | | | | | | | | | | | | Fixes: #26261 Co-authored-by: Craig Scott <craig.scott@crascit.com>
* | | | Merge topic 'deprecate-pre-3.10'Brad King2024-10-042-0/+15
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 84db8506ff Deprecate compatibility with CMake versions older than 3.10 9e3b559b6a Tests: Update cmake_minimum_required versions to 3.10 f4aa34daa7 Tests/RunCMake: Update cmake_minimum_required versions to 3.10 1d38d52995 Tests/RunCMake: Match diagnostic line numbers more robustly 55778f5a16 ExternalProject: Enable all policies in internal scripts Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9875
| * | | | Deprecate compatibility with CMake versions older than 3.10Brad King2024-10-032-0/+15
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Issue a deprecation warning on calls to `cmake_minimum_required` or `cmake_policy` that set policies based on versions older than 3.10. Note that the effective policy version includes `...<max>` treatment. Update the check from commit 3a4791548d (Deprecate compatibility with CMake versions older than 3.5, 2023-02-09, v3.27.0-rc1~508^2).