summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'file-set-repr-improvements' into release-3.23Brad King2022-04-123-13/+16
|\ | | | | | | | | | | | | | | | | 5fa15ec9f3 Help: Document that target_sources defines [INTERFACE_]HEADER_SETS c5d4812f20 cmTarget: make HEADER_SETS and INTERFACE_HEADER_SETS read-only 05783b168d cmFileSet: store visibility with the fileset Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7168
| * Help: Document that target_sources defines [INTERFACE_]HEADER_SETSBrad King2022-04-123-0/+10
| |
| * cmTarget: make HEADER_SETS and INTERFACE_HEADER_SETS read-onlyBen Boeckel2022-04-113-15/+8
| | | | | | | | | | | | There is no reason to allow these properties to be manipulated by user code. Instead, use the stored visibility on the fileset objects to derive what these properties should contain.
* | Merge branch 'release-3.22' into release-3.23Brad King2022-04-121-3/+10
|\ \ | |/ |/|
| * CMake 3.22.4v3.22.4Brad King2022-04-121-3/+10
| |
* | Merge branch 'doc-qhelpgenerator' into release-3.23Brad King2022-04-081-0/+5
|\ \ | |/ | | | | Merge-request: !7150
| * Help: Add "Updates" section header in 3.22 release notesBrad King2022-04-071-0/+5
| | | | | | | | | | This was accidentally left out in commit 1461eff899 (Help: Add missing 3.22.1 section to the release notes, 2022-01-24, v3.22.2~1^2).
* | FILE_SET: Forbid adding header sets to Apple FRAMEWORK librariesKyle Edwards2022-04-072-1/+15
| | | | | | | | | | | | | | | | The feature needs a specialized implementation to place headers in the right place inside frameworks. To avoid silently doing the wrong thing, make this case an error for the 3.23 series. Issue: #23386
* | Merge branch 'backport-3.22-ci-package-uploads' into ci-package-uploadsBrad King2022-04-041-17/+1
|\ \ | |/
| * gitlab-ci: distinguish release and development pipeline schedulesBrad King2022-04-041-17/+1
| | | | | | | | | | | | | | | | Redefine the `CMAKE_CI_PACKAGE` pipeline schedule variable to indicate whether it is for a development version (`dev`) or a release version (`v[0-9]...`). Use this to automatically turn package upload jobs on or off without having to edit the jobs in `.gitlab-ci.yml` for release branches.
* | Merge topic 'doc-CMP0112' into release-3.23Brad King2022-04-041-1/+3
|\ \ | | | | | | | | | | | | | | | | | | 9993774172 Help: Clarify when policy CMP0112 takes effect Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7134
| * | Help: Clarify when policy CMP0112 takes effectBrad King2022-04-011-1/+3
| | | | | | | | | | | | Fixes: #23381
* | | Help: Fix typo in install command documentationEugene Shalygin2022-04-031-1/+1
|/ /
* | Merge topic 'help-variables-cmakecachefiledir-might-not-be-defined' into ↵Brad King2022-03-311-4/+3
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | release-3.23 cf4100d7da Help: Add that CMAKE_CACHEFILE_DIR might not be defined Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7125
| * | Help: Add that CMAKE_CACHEFILE_DIR might not be definedTobias Nießen2022-03-301-4/+3
| | | | | | | | | | | | | | | | | | | | | CMake only sets `CMAKE_CACHEFILE_DIR` when writing `CMakeCache.txt`, so the variable will usually be undefined when `CMakeLists.txt` runs. Revise its documentation to clarify that `CMAKE_BINARY_DIR` should be used instead.
* | | Help: Fix string(JSON ... LENGTH ...) signatureTobias Nießen2022-03-301-1/+1
|/ / | | | | | | | | The list of indices and/or member names is optional, i.e., can be empty. For example, string(JSON foo LENGTH "[0,0,0]") sets foo to 3.
* | Help: Clean up and expand CPack/IFW docsCraig Scott2022-03-271-101/+122
| |
* | 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
| |\ \
generated by cgit v0.12 at 2025-01-27 04:15:04 (GMT)