summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'better_cross-ref_CMAKE_FIND_NO_INSTALL_PREFIX' into release-3.23Brad 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
| |
* | 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
| * 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' 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
| * | 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' 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
| * | 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' 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
| * | Help: Clarify when add_test and test properties support generator expressionsBrad King2022-03-213-8/+26
| |/ | | | | | | Issue: #23329
* | Help: Add more detail for CPACK_PRODUCTBUILD_DOMAINS* variablesCraig Scott2022-03-212-13/+34
|/
* 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
* 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
| * 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
* | 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
| * | 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
* | Help: Fix typo and improve readability for LINK_LIBRARIES_ONLY_TARGETSCraig Scott2022-03-131-4/+3
|/
* Merge topic 'doc-file-sets' into release-3.23Brad King2022-03-098-98/+138
|\ | | | | | | | | | | | | | | 4286b72240 Help: Update install() docs to better reflect preference for file sets ab1b573f41 Help: Reorganise FILE_SETS and related properties Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7031
| * Help: Update install() docs to better reflect preference for file setsCraig Scott2022-03-081-21/+39
| | | | | | | | | | | | | | Previously, headers would typically be installed as bare files or as whole directories. File sets offer a better abstraction and associate headers with a target, installing them as part of the target. Add notes and update examples to draw the reader's attention to the advantages of file sets for headers.
| * Help: Reorganise FILE_SETS and related propertiesCraig Scott2022-03-057-77/+99
| | | | | | | | | | | | | | | | | | | | | | | | Reduce duplication and make the docs for target_sources() focus on the functionality rather than the properties it modifies. The properties are a lower level quantity, so put the relevant details for them in the property documentation. The target_sources() command only needs to reference the properties, not reproduce the property documentation. Improve the cross-referencing between the HEADER_... property docs. This helps build the mental picture of how they relate to each other.
* | Merge topic 'cmake-presets-file-dir' into release-3.23Brad King2022-03-082-0/+8
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | f54507c2f6 CMakePresets.json: Add ${fileDir} macro Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: Gerhard Olsson <gerhard.nospam@gmail.com> Merge-request: !7051
| * | CMakePresets.json: Add ${fileDir} macroKyle Edwards2022-03-072-0/+8
| | | | | | | | | | | | Fixes: #23214
* | | Merge topic 'doc-lang-std-features' into release-3.23Brad King2022-03-085-0/+15
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | fbda79f39d Help: Document explicitly that 'cxx_std_##' features may not add a flag Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: antmak <antmak.pub@gmail.com> Merge-request: !7043
| * | Help: Document explicitly that 'cxx_std_##' features may not add a flagBrad King2022-03-075-0/+15
| | | | | | | | | | | | | | | This is commonly reported incorrectly as a bug, so call out this behavior explicitly in the documentation.
* | | Merge branch 'release-3.22' into release-3.23Brad King2022-03-041-0/+9
|\ \ \
| * | | CMake 3.22.3v3.22.3Brad King2022-03-041-0/+9
| | | |
* | | | Merge branch 'release-3.22' into release-3.23Brad King2022-03-041-3/+3
|\ \ \ \ | |/ / / | | | / | |_|/ |/| |
| * | Merge branch 'release-3.21' into release-3.22Brad King2022-03-041-3/+3
| |\ \
| | * | CMake 3.21.6v3.21.6Brad King2022-03-041-3/+3
| | | |
| * | | Merge branch 'doc-MSVC_TOOLSET_VERSION-v143' into release-3.22Brad King2022-02-091-0/+1
| |\ \ \ | | |/ / | | | | | | | | Merge-request: !6966
| * | | Merge branch 'release-3.21' into release-3.22Brad King2022-02-011-0/+7
| |\ \ \
| * \ \ \ Merge topic 'help-try-compile-result-var' into release-3.22Brad King2022-02-012-13/+0
| |\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 34d263270e Help: Drop incorrect versionadded for try_compile result variable Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6923
* | \ \ \ \ Merge topic 'file-set-name-requirements' into release-3.23Brad King2022-03-041-1/+2
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | b357d334fc target_sources(): Enforce stricter requirements for FILE_SET name Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7037
| * | | | | | target_sources(): Enforce stricter requirements for FILE_SET nameKyle Edwards2022-03-031-1/+2
| | |_|_|_|/ | |/| | | | | | | | | | | | | | | | Fixes: #23286
* | | | | | target_sources(): Process multiple FILE_SET arguments per blockKyle Edwards2022-03-031-2/+3
|/ / / / / | | | | | | | | | | | | | | | Fixes: #23287
* | | | | Merge topic 'cuda-arch-all' into release-3.23Brad King2022-03-021-8/+10
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2796d6eeca CUDA: Fix CMAKE_CUDA_ARCHITECTURES=all/all-major with NVCC 11.5+ e450d55552 Help: Update CUDA_ARCHITECTURES docs for generic all/all-major support fe64c49e72 CUDA: Simplify CMAKE_CUDA_ARCHITECTURES special value logic Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7026
| * | | | | Help: Update CUDA_ARCHITECTURES docs for generic all/all-major supportBrad King2022-03-011-8/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since commit 8f64df0a7c (CUDA: Generic all and all-major support, 2021-12-19, v3.23.0-rc1~23^2), these special values do not require any specific compiler or version. While at it, re-organize CUDA_ARCHITECTURES special value documentation. Move the `versionadded` markup inside each special value so we can add more in future versions.
* | | | | | Merge topic 'doc-presets-v4' into release-3.23Brad King2022-03-022-43/+69
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6404751176 Help: Improve wording and structure related to preset includes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7028
| * | | | | | Help: Improve wording and structure related to preset includesCraig Scott2022-03-022-43/+69
| |/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Encourage placing preset includes near the beginning of a preset file and ensure the example shows that usage. Move the prose discussing includes to its own section to improve discoverability and break up paragraphs to make each main point harder to miss. Also clarify ${sourceDir} to remove any ambiguity with regard to its meaning in included files. Issue: #23214
* | | | | | Merge topic 'file-set-no-custom-targets' into release-3.23Brad King2022-03-021-1/+2
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ad41c9cd11 target_sources(): Prohibit FILE_SET on custom targets Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7027
| * | | | | | target_sources(): Prohibit FILE_SET on custom targetsKyle Edwards2022-02-281-1/+2
| |/ / / / / | | | | | | | | | | | | | | | | | | Fixes: #23262
* | | | | | Help: Add missing versionadded to *CROSSCOMPILING_EMULATORfriendlyanon2022-02-282-6/+8
|/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The list capability was added in CMake 3.15 by commit fec441ec17 (Teach CROSSCOMPILING_EMULATOR to support arguments, 2019-05-30, v3.15.0-rc1~6^2), but the documentation did not indicate the version that added it.
* | | | | Merge topic 'vs-package-restore-docs' into release-3.23Brad King2022-02-163-26/+28
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | d92469e572 Help: Clarify how package resolve mode is intended to be used f320a31087 cmake --build: prioritize --resolve-package-references over preset Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6984
| * | | | | Help: Clarify how package resolve mode is intended to be usedCarsten Rudolph2022-02-153-8/+12
| | | | | | | | | | | | | | | | | | | | | | | | Fixes: #23223
| * | | | | cmake --build: prioritize --resolve-package-references over presetCarsten Rudolph2022-02-152-18/+16
| | | | | | | | | | | | | | | | | | | | | | | | Fixes: #23224
generated by cgit v0.12 at 2025-02-03 05:54:25 (GMT)