summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'link-interface-direct'Brad King2022-03-255-17/+69
|\ | | | | | | | | | | | | | | | | | | cf312a2e54 LINK_LIBRARIES: Add support for LINK_ONLY genex 41a6b4a53b INTERFACE_LINK_LIBRARIES_DIRECT: Honor link dependencies through LINK_ONLY 73337cb383 LINK_LIBRARIES: Evaluate separately for linking and usage requirements Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7107
| * LINK_LIBRARIES: Add support for LINK_ONLY genexBrad King2022-03-244-6/+45
| | | | | | | | | | | | | | Previously we always used content guarded by `$<LINK_ONLY:...>` in `LINK_LIBRARIES`, even when evaluating for non-linking usage requirements. Add a policy to honor `LINK_ONLY` in `LINK_LIBRARIES` the same way we already do in `INTERFACE_LINK_LIBRARIES`.
| * INTERFACE_LINK_LIBRARIES_DIRECT: Honor link dependencies through LINK_ONLYBrad King2022-03-221-11/+24
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In commit f3ad061858 (Add usage requirements to update direct link dependencies, 2022-01-12, v3.23.0-rc1~44^2), we evaluated the transitive closure of `INTERFACE_LINK_LIBRARIES` as a non-linking usage requirement. That left out `INTERFACE_LINK_LIBRARIES_DIRECT` link dependencies that appear behind private dependencies of a static library, guarded by the `$<LINK_ONLY:...>` generator expression. At the time, that decision was intentional, in order to prevent arbitrary usage requirements from leaking out of `PRIVATE` dependencies. Since then, we've revised evaluation of `LINK_LIBRARIES` to distinguish between collecting link dependencies and other usage requirements. Use that information when following `INTERFACE_LINK_LIBRARIES` to collect the matching kind of requirements from `INTERFACE_LINK_LIBRARIES_DIRECT`. Fixes: #22496
* | Merge topic 'cmake-fresh'Brad King2022-03-252-0/+12
|\ \ | | | | | | | | | | | | | | | | | | | | | 9f1471739d cmake: Add --fresh option to clear the cache and start from scratch Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !7099
| * | cmake: Add --fresh option to clear the cache and start from scratchBrad King2022-03-222-0/+12
| | | | | | | | | | | | | | | | | | | | | Simplify the workflow to re-run CMake from scratch as if a build tree were never before processed, regardless of whether it has been. Fixes: #23119
* | | cmake -E tar: Add --touch optionKasper Laudrup2022-03-233-1/+18
| | | | | | | | | | | | | | | | | | | | | | | | Similar to GNU tar add a --touch option to the tar extract command to skip extracting the timestamps from the files in the archive effectively touching them as if they were just created. Issue: #22746
* | | Merge topic 'better_cross-ref_CMAKE_FIND_NO_INSTALL_PREFIX'Brad King2022-03-232-2/+5
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 7dc654a017 Help: Better cross-reference CMAKE_FIND_NO_INSTALL_PREFIX Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7097
| * | | Help: Better cross-reference CMAKE_FIND_NO_INSTALL_PREFIXRobert Maynard2022-03-232-2/+5
| | | |
* | | | Merge topic 'initialize-property-name'Brad King2022-03-231-2/+4
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 26caa97057 define_property(): Change constraints of INITIALIZE_FROM_VARIABLE Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7103
| * | | | define_property(): Change constraints of INITIALIZE_FROM_VARIABLEKyle Edwards2022-03-231-2/+4
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | Remove the requirement that the variable name have a prefix while keeping the suffix requirement. Require that the property name contains an underscore. Update docs and tests accordingly. Fixes: #23340
| * | | Merge topic 'revert-link-interface-direct-for-3.23' into release-3.23Brad King2022-03-227-284/+0
| |\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 687a91967f Revert INTERFACE_LINK_LIBRARIES_DIRECT feature for 3.23 branch Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7098
| * \ \ \ Merge topic 'tutorial-license-name' into release-3.23Brad King2022-03-221-1/+1
| |\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6892002fcb Tutorial: Fix casing of reference to License.txt Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7100
| * \ \ \ \ Merge topic 'cleanup-define_property' into release-3.23Brad King2022-03-221-11/+15
| |\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 87c3b5e421 define_property(): Only test prefix if INITIALIZE_FROM_VARIABLE is given 9b50f221f6 Help: Update the main purpose of define_property() e993e2c52c Help: Clean up INITIALIZE_FROM_VARIABLE define_property() option Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: Kyle Edwards <kyle.edwards@kitware.com> Merge-request: !7090
| * \ \ \ \ \ Merge topic 'doc-test-property-genex' into release-3.23Brad King2022-03-223-8/+26
| |\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 78e0204e81 Help: Clarify when add_test and test properties support generator expressions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7101
* | \ \ \ \ \ \ Merge topic 'LINK_GROUP-feat-RESCAN-on-BSD-systems'Brad King2022-03-232-6/+7
|\ \ \ \ \ \ \ \ | |_|_|_|_|_|_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | d658332782 Genex-LINK_GROUP: Add support feature RESCAN on BSD systems Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7104
| * | | | | | | Genex-LINK_GROUP: Add support feature RESCAN on BSD systemsMarc Chevrier2022-03-222-6/+7
| | |_|_|_|_|/ | |/| | | | |
* | | | | | | Merge topic 'revert-link-interface-direct-for-3.23'Brad King2022-03-224-7/+9
|\ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 75c701f66f Help: Update INTERFACE_LINK_LIBRARIES_DIRECT to be added in 3.24 0a35b70c24 Merge branch 'revert-link-interface-direct-for-3.23' 687a91967f Revert INTERFACE_LINK_LIBRARIES_DIRECT feature for 3.23 branch Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7098
| * | | | | | | Help: Update INTERFACE_LINK_LIBRARIES_DIRECT to be added in 3.24Brad King2022-03-223-2/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This feature has been reverted from the 3.23 release branch. Update its documentation and release note to target 3.24 instead. Issue: #22496
| * | | | | | | Merge branch 'revert-link-interface-direct-for-3.23'Brad King2022-03-221-5/+0
| |\ \ \ \ \ \ \ | | | |_|_|_|_|/ | | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Use the "ours" merge strategy because we only want to revert the change from the 3.23 branch, not from `master`. It will be revised for inclusion in a future release series. Manually remove the 3.23 release note that would have been removed by this merge without the "ours" strategy.
| | * | | | | | Revert INTERFACE_LINK_LIBRARIES_DIRECT feature for 3.23 branchBrad King2022-03-217-284/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Revert commit f3ad061858 (Add usage requirements to update direct link dependencies, 2022-01-12, v3.23.0-rc1~44^2) and the property storage updates in its predecessor commit 193a999cd5 (cmTarget: Add INTERFACE_LINK_LIBRARIES_DIRECT{,_EXCLUDE} backtrace storage, 2022-01-06, v3.23.0-rc1~44^2~1) from the 3.23 release branch. After initial experience using the feature in practice, additional design considerations have been raised for discussion in the original issue. To avoid rushing this for the 3.23 series, we've decided to revert the feature for now so it can be revised for a future release. Issue: #22496
* | | | | | | | Merge topic 'tutorial-license-name'Brad King2022-03-221-1/+1
|\ \ \ \ \ \ \ \ | | |_|_|_|_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6892002fcb Tutorial: Fix casing of reference to License.txt Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7100
| * | | | | | | Tutorial: Fix casing of reference to License.txtØystein Sørensen2022-03-211-1/+1
| | |/ / / / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | Correct a tiny typo in the Step 7 tutorial. Change so `License.txt` correctly starts with a capital `L`.
* | | | | | | Merge topic 'cleanup-define_property'Brad King2022-03-221-11/+15
|\ \ \ \ \ \ \ | | |_|_|_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 87c3b5e421 define_property(): Only test prefix if INITIALIZE_FROM_VARIABLE is given 9b50f221f6 Help: Update the main purpose of define_property() e993e2c52c Help: Clean up INITIALIZE_FROM_VARIABLE define_property() option Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: Kyle Edwards <kyle.edwards@kitware.com> Merge-request: !7090
| * | | | | | Help: Update the main purpose of define_property()Craig Scott2022-03-191-7/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The BRIEF_DOCS and FULL_DOCS are remnants from before the Sphinx-based documentation when CMake's internal structures for defining properties included fields for their documentation. They are no longer mandatory for define_property() and haven't been in practical use for some time. The main use of the command has evolved to now be more about how to initialize and inherit properties, so update the docs to reflect that change in focus. Issue: #20698
| * | | | | | Help: Clean up INITIALIZE_FROM_VARIABLE define_property() optionCraig Scott2022-03-191-4/+6
| |/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | INITIALIZE_FROM_VARIABLE is new in CMake 3.23, but the versionadded note was missing in the original commit. The docs also failed to mention that the new option only applies to target properties. Amends fce24e4f10 (define_property(): Add INITIALIZE_FROM_VARIABLE argument, 2022-01-13)
* | | | | | Merge topic 'doc-test-property-genex'Brad King2022-03-223-8/+26
|\ \ \ \ \ \ | | |_|_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | 78e0204e81 Help: Clarify when add_test and test properties support generator expressions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7101
| * | | | | Help: Clarify when add_test and test properties support generator expressionsBrad King2022-03-213-8/+26
| |/ / / / | | | | | | | | | | | | | | | Issue: #23329
* | | | | Merge topic 'doc-productbuild'Brad King2022-03-222-13/+34
|\ \ \ \ \ | |_|_|/ / |/| | | / | | |_|/ | |/| | | | | | | | | | bf44efadab Help: Add more detail for CPACK_PRODUCTBUILD_DOMAINS* variables Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7091
| * | | Help: Add more detail for CPACK_PRODUCTBUILD_DOMAINS* variablesCraig Scott2022-03-212-13/+34
| |/ /
* | | Merge topic 'ghs_predefined_targets'Brad King2022-03-211-0/+6
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 399e73b89a GHS: release note 829e946c69 GHS: Update tests for updated binary layout 93c1acd8ff GHS: List predefined targets before user targets in GUI bdb213819c GHS: Do not include WindowsPaths b3e9c72901 GHS: use INSTALL target a645287784 GHS: update build command 724b5491ef GHS: Rearrange project files in binary directory edff0f6a1d GHS: Use Custom Target for ALL_BUILD ... Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !7079
| * | | GHS: release noteFred Baksik2022-03-171-0/+6
| | | |
* | | | Merge topic 'LINK_LIBRARY-WHOLE_ARCHIVE'Brad King2022-03-214-11/+43
|\ \ \ \ | |_|_|/ |/| | | | | | | | | | | | | | | | | | | | | | | dabe56de58 genex-LINK_LIBRARY: Add feature WHOLE_ARCHIVE Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: huangqinjin <huangqinjin@gmail.com> Merge-request: !7064
| * | | genex-LINK_LIBRARY: Add feature WHOLE_ARCHIVEMarc Chevrier2022-03-174-11/+43
| | | |
* | | | Merge topic 'doc-multiple-src-paths'Brad King2022-03-182-0/+13
|\ \ \ \ | |_|/ / |/| | / | | |/ | |/| | | | | | | 1b8669c1d6 Help: Document warning about multiple source paths Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7082
| * | Help: Document warning about multiple source pathsBrad King2022-03-182-0/+13
| | | | | | | | | | | | | | | | | | | | | | | | Although passing multiple source paths was never documented, it was not diagnosed by CMake 3.22 and below. In CMake 3.23 we now diagnose extra paths and warn. Document this change and add a release note. Issue: #23334
* | | Merge topic 'doc-src-bld-selection'Brad King2022-03-171-0/+20
|\ \ \ | |/ / | | | | | | | | | | | | | | | fea270d3ed Help: Document cmake source and binary dir selection rules Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7076
| * | Help: Document cmake source and binary dir selection rulesRobert Maynard2022-03-171-0/+20
| | | | | | | | | | | | Co-authored-by: Brad King <brad.king@kitware.com>
| * | Merge topic 'doc-list-semicolons' into release-3.23Brad King2022-03-163-8/+51
| |\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 8abd714176 Help: Clarify that ENVIRONMENT test properties take ;-separated lists 02cf404ace Help: Add advice for dealing with semicolons in lists c4117d9116 ExternalProject: Document that LIST_SEPARATOR works for CMAKE_ARGS too Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !7066
* | \ \ Merge topic 'findzlib-static'Brad King2022-03-161-0/+5
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 185723461f FindZLIB: more library names + option to prefer static library Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7067
| * | | | FindZLIB: more library names + option to prefer static libraryPeter Würth2022-03-121-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Adds additional library names `zlibstat[d]` and `zlibvc[d]` for Windows, when zlib is built using one of the Visual Studio solutions under `zlib/contrib/vstudio`. Adds a `ZLIB_USE_STATIC_LIBS` option that is equivilent to similar settings in other modules such as FindProtobuf, FindOpenSSL, etc. Implements #18029 and #23140
* | | | | Merge topic 'doc-list-semicolons'Brad King2022-03-163-8/+51
|\ \ \ \ \ | | |_|/ / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 8abd714176 Help: Clarify that ENVIRONMENT test properties take ;-separated lists 02cf404ace Help: Add advice for dealing with semicolons in lists c4117d9116 ExternalProject: Document that LIST_SEPARATOR works for CMAKE_ARGS too Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !7066
| * | | | Help: Clarify that ENVIRONMENT test properties take ;-separated listsBrad King2022-03-152-8/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Follow up commit 79f64cc773 (Help: ENVIRONMENT_MODIFICATION clarify only supports singular values, 2022-02-23) to specifically call out the list format. Issue: #23315
| * | | | Help: Add advice for dealing with semicolons in listsBrad King2022-03-151-0/+42
| | | | | | | | | | | | | | | | | | | | Issue: #23315
* | | | | Merge topic 'language-header-file-only-doc'Brad King2022-03-161-2/+2
|\ \ \ \ \ | | |_|/ / | |/| | | | | | | | | | | | | | | | | | | | | | | 83a80e5193 Help: Clarify interaction of LANGUAGE and HEADER_FILE_ONLY Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7075
| * | | | Help: Clarify interaction of LANGUAGE and HEADER_FILE_ONLYKyle Edwards2022-03-151-2/+2
| | | | |
| * | | | Merge topic 'doc-ignore-prefix-paths' into release-3.23Brad King2022-03-1511-51/+98
| |\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5cb0a730c9 Help: Clarify behavior of search ignore-related variables Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7056
* | \ \ \ \ Merge topic 'doc-ignore-prefix-paths'Brad King2022-03-1511-51/+98
|\ \ \ \ \ \ | | |/ / / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | 5cb0a730c9 Help: Clarify behavior of search ignore-related variables Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7056
| * | | | | Help: Clarify behavior of search ignore-related variablesCraig Scott2022-03-1311-51/+98
| | |/ / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Not all the behaviors of CMake variables for ignoring search locations by find_...() commands were fully documented. Add the missing effects, clarify the wording and restructure the way the details are assembled to reduce duplication. Also improve the cross-referencing to ensure all the related variables are more discoverable. Issue: #20878
* | | | | Merge topic 'doc-LINK_LIBRARIES_ONLY_TARGETS'Craig Scott2022-03-141-4/+3
|\ \ \ \ \ | | |/ / / | |/| / / | |_|/ / |/| | | | | | | | | | | 95cdce829f Help: Fix typo and improve readability for LINK_LIBRARIES_ONLY_TARGETS Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7068
| * | | Help: Fix typo and improve readability for LINK_LIBRARIES_ONLY_TARGETSCraig Scott2022-03-131-4/+3
| |/ /