summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* 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
| |/ /
| * | 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
| * \ \ 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
| * \ \ \ 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
* | \ \ \ \ Merge topic 'find_package-global-imported'Brad King2022-03-114-1/+27
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2f1ffa003c find_package: Add support for default GLOBAL imported targets Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !6862
| * | | | | | find_package: Add support for default GLOBAL imported targetsJohn Parent2022-03-104-1/+27
| | |_|_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Allow find package to promote scope of imported targets by specifying an argument to `find_package` or by specifying a CMake variable. * Add support for CMAKE_GLOBAL_IMPORT_SCOPE variable * Add support for GLOBAL argument to find_package Additionally add testing for above features.
* | | | | | CUDA: Add support for CUDA_ARCHITECTURES=nativeBrad King2022-03-102-0/+12
|/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | CUDA 11.6 added the `nvcc -arch=native` flag to automatically compile for the host GPUs' architectures. Add support for specifying this special `native` value in `CMAKE_CUDA_ARCHITECTURES` and `CUDA_ARCHITECTURES`. During the compiler ABI detection step, detect the native architectures so we can pass them explicitly when using Clang or older versions of nvcc. Fixes: #22375
* | | | | Merge topic 'ctest_truncate'Brad King2022-03-099-8/+103
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 140704d443 ctest: add option for output truncation 359e5b17d8 presets: bump version to v5 4634de335b cmCTestTestHandler: refactor CleanTestOutput method Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6993
| * | | | | ctest: add option for output truncationFrank Winklmeier2022-03-088-5/+54
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add `--test-output-truncation` to `ctest`. This option can be used to customize which part of the test output is being truncated. Currently supported values are `tail`, `middle` and `head`. Also add equivalent `CTEST_CUSTOM_TEST_OUTPUT_TRUNCATION` variable. Fixes: #23206
| * | | | | presets: bump version to v5Frank Winklmeier2022-03-083-4/+50
| | | | | | | | | | | | | | | | | | | | | | | | Prepare for new test preset fields.
* | | | | | Merge topic 'color-diagnostics'Brad King2022-03-095-0/+58
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6ab9fbd43b color: Add tests for CMAKE_COLOR_DIAGNOSTICS 78adb1b952 color: Add CMAKE_COLOR_DIAGNOSTICS environment variable 884d9de8b7 color: Introduce CMAKE_COLOR_DIAGNOSTICS variable Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: Frank Dana <ferdnyc@gmail.com> Merge-request: !6990
| * | | | | | color: Add CMAKE_COLOR_DIAGNOSTICS environment variableSemyon Kolton2022-03-084-1/+16
| | | | | | |
| * | | | | | color: Introduce CMAKE_COLOR_DIAGNOSTICS variableSemyon Kolton2022-03-083-0/+43
| |/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a variable to control both makefile color messages and compiler color diagnostics. Fixes: #15502
* | | | | | Merge topic 'doc-file-sets'Brad 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'Brad 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 branch 'release-3.22' into release-3.23Brad King2022-03-041-0/+9
| |\ \ \ \
| * \ \ \ \ Merge branch 'release-3.22' into release-3.23Brad King2022-03-041-3/+3
| |\ \ \ \ \ | | |_|/ / / | |/| | | |
| * | | | | 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