summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
...
| * | | | | | cmake_language: Add EXIT subcommandleha-bot2024-01-162-0/+28
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add tests to cover these cases: * run as regular CMake module, in NORMAL_MODE (expected to fail); * run as CMake script in SCRIPT_MODE (expected to exit with given code); * run as CMake script that `include()`-s another script with EXIT subcommand; * run as CMake script which EVAL-uates EXIT subcommand via `cmake_language(EVAL CODE "<cmake code>")`. Fixes: #23162
* | | | | | | Help: Fix typo in CMP0156 documentationBrad King2024-01-161-1/+1
| |_|/ / / / |/| | | | |
* | | | | | Help: Clarify standard policy advice paragraph wording on how policies are setBrad King2024-01-111-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | Avoid implying that a policy must always be set explicitly.
* | | | | | Help: Drop current CMake version from standard policy advice paragraphBrad King2024-01-111-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Every policy documents whether CMake warns when it is not set. This behavior does not change with the CMake version, so avoid possibly confusing mention of the current CMake version.
* | | | | | Help: Normalize and consolidate standard policy advice paragraphBrad King2024-01-11152-557/+510
|/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
* | | | | Merge topic 'file-strings-regex-match'Brad King2024-01-114-2/+30
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | fa00928bcd file: `STRINGS` + `REGEX` store match results ff0085cf74 Help: Drop incorrect versionadded mark from CMAKE_MATCH_<n> Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9124
| * | | | | file: `STRINGS` + `REGEX` store match resultsCristian Le2024-01-093-0/+30
| | | | | | | | | | | | | | | | | | | | | | | | Signed-off-by: Cristian Le <cristian.le@mpsd.mpg.de>
| * | | | | Help: Drop incorrect versionadded mark from CMAKE_MATCH_<n>Brad King2024-01-091-2/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | It was added by commit 496ec6036f (Help: Add Sphinx 'versionadded' directives to each top-level document, 2020-07-06, v3.19.0-rc1~558^2) because the document happened to be added during the 3.9 release series, but the variable has existed since the beginning.
* | | | | | Merge topic 'cxxmodules-no-unity'Brad King2024-01-103-0/+13
|\ \ \ \ \ \ | | |_|_|/ / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 63bbb3768d cmLocalGenerator: ignore scanned sources for unity builds 76b5383123 cmGlobalGenerator: add unity sources after computing target compile features 7fc2a83fe6 Tests/CXXModules: add a test with unity build support Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9118
| * | | | | cmLocalGenerator: ignore scanned sources for unity buildsBen Boeckel2024-01-053-0/+13
| | | | | |
* | | | | | Merge topic 'ctest-cli-http-headers'Brad King2024-01-092-0/+15
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 20adf8cfce ctest: allow HTTP headers via command line Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9123
| * | | | | | ctest: allow HTTP headers via command lineMatthew Woehlke2024-01-082-0/+15
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Add ability to specify HTTP headers via `ctest -T Submit`.
* | | | | | | Merge topic 'doc-INSTALL_PREFIX'Brad King2024-01-091-4/+7
|\ \ \ \ \ \ \ | |_|_|/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 925f9f18dd Help: INSTALL_PREFIX in install(CODE|SCRIPT) was added in CMake 3.27 Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Alex <leha-bot@yandex.ru> Acked-by: Frank Dana <ferdnyc@gmail.com> Merge-request: !9135
| * | | | | | Help: INSTALL_PREFIX in install(CODE|SCRIPT) was added in CMake 3.27Peter Kokot2024-01-081-4/+7
| | |_|_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | In commit 18e02ace5b (install(CODE|SCRIPT): Support $<INSTALL_PREFIX> genex, 2023-02-24, v3.27.0-rc1~431^2) we documented the feature without stating what version added it.
* | | | | | Merge topic 'fix-tutorial'Brad King2024-01-083-6/+6
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6d48bd21ac Tutorial: Clarify the expected change to target_include_directories 4d56db038d Tutorial: Make `INSTALL_DESTINATION` consistent with installed destination da22b269b2 Tutorial: Add missing `$` in generator expression Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9120
| * | | | | | Tutorial: Clarify the expected change to target_include_directoriesKevin Albertson2024-01-051-4/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The expectation is to modify the existing `target_include_directories`, not add add a new `target_include_directories` command.
| * | | | | | Tutorial: Make `INSTALL_DESTINATION` consistent with installed destinationKevin Albertson2024-01-051-1/+1
| | | | | | |
| * | | | | | Tutorial: Add missing `$` in generator expressionKevin Albertson2024-01-051-1/+1
| | |/ / / / | |/| | | |
* | | | | | add_test: Fix version of CMake introducing CMP0158 (to 3.29)Robert Maynard2024-01-051-0/+2
| |/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | This was missed in commit ca5a300d7f (add_test: Honor CROSSCOMPILING_EMULATOR only when cross-compiling, 2023-11-02) when it slipped from the 3.28 release.
* | | | | Merge topic 'doc-get-properties-inherited'Brad King2024-01-057-34/+32
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 8086badba4 Help: Fix wrong return values for unset inherited properties 1ca5ec67b0 Help: Add missing DIRECTORY keyword to set_tests_properties() signature 34379f005b Help: Use <variable> consistently in property getter commands 29ccc9a4cd Help: Use <xxx> for non-keyword arguments in property command signatures Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9131
| * | | | Help: Fix wrong return values for unset inherited propertiesCraig Scott2024-01-053-22/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since ff6234509e (Help: Clarify behavior of INHERITED properties, 2018-03-21), the docs for some get_..._property() commands incorrectly describe the behavior for inherited properties. When a property is not set, even in a parent scope, the returned result from the get_..._property() command is the same whether the property is inherited or not. The docs incorrectly stated that an empty string would be returned for inherited properties in such cases.
| * | | | Help: Add missing DIRECTORY keyword to set_tests_properties() signatureCraig Scott2024-01-051-0/+1
| | | | |
| * | | | Help: Use <variable> consistently in property getter commandsCraig Scott2024-01-053-14/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Property-related commands used a mix of <VAR>, <var>, or <variable> to specify the variable to store the result in. The <VAR> form is particularly confusing, since being uppercase it looks more like a keyword. Use <variable> consistently across all the commands so that the behavior is clear.
| * | | | Help: Use <xxx> for non-keyword arguments in property command signaturesCraig Scott2024-01-055-12/+15
| | |/ / | |/| |
| * | | Merge topic 'HELP-string_LENGTH-link-error' into release-3.28Brad King2024-01-041-1/+1
| |\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 9702a01dc9 Help: string(LENGTH): Fix synopsis link to command description Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9113
| * \ \ \ Merge topic 'revert-ExternalProject-download-byproducts' into release-3.28Brad King2024-01-041-6/+0
| |\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | fd3c9876c6 ExternalProject: revert `BYPRODUCTS` for download outputs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9097
* | \ \ \ \ Merge topic 'fix_documentation'Brad King2024-01-041-2/+2
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 20f74231db Help: Fix Step3 Mathfunction example Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9101
| * | | | | | Help: Fix Step3 Mathfunction exampleBhavith C2023-12-231-2/+2
| | |_|_|/ / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | - TODO 6 has to be Link SqrtLibrary - TODO 7 has to be Link MathFunctions Signed-off-by: Bhavith C <bhavithc.acharya@gmail.com>
* | | | | | Merge topic 'HELP-string_LENGTH-link-error'Brad King2024-01-041-1/+1
|\ \ \ \ \ \ | | |_|_|/ / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | 9702a01dc9 Help: string(LENGTH): Fix synopsis link to command description Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9113
| * | | | | Help: string(LENGTH): Fix synopsis link to command descriptionMarc Chevrier2024-01-031-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Make the link target explicit to avoid ambiguity with `JSON LENGTH`. Fixes: #25546
* | | | | | Merge topic 'revert-ExternalProject-download-byproducts'Brad King2024-01-041-6/+0
|\ \ \ \ \ \ | | |_|_|/ / | |/| | | / | |_|_|_|/ |/| | | | | | | | | | | | | | fd3c9876c6 ExternalProject: revert `BYPRODUCTS` for download outputs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9097
| * | | | ExternalProject: revert `BYPRODUCTS` for download outputsBen Boeckel2024-01-031-6/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Xcode has been reported to not work at all with this when ExternalProject projects share download files. Revert commit 872daff159 (ExternalProject: declare byproducts for the download step, 2023-09-21, v3.28.0-rc1~27^2) pending further investigation. Fixes: #25525
* | | | | Merge topic 'doc-dynamic-resource-spec-file'Craig Scott2024-01-021-20/+28
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | 9b63f92f27 Help: Update missed text for dynamically generated resource spec files Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9117
| * | | | Help: Update missed text for dynamically generated resource spec filesCraig Scott2024-01-011-20/+28
| | | | |
| * | | | Merge topic 'fix-redirect-links' into release-3.28Craig Scott2024-01-011-1/+1
| |\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5a7927d028 Help: update lua.org links to be HTTPS Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9114
* | \ \ \ \ Merge topic 'fix-redirect-links'Craig Scott2024-01-011-1/+1
|\ \ \ \ \ \ | | |/ / / / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | 5a7927d028 Help: update lua.org links to be HTTPS Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9114
| * | | | | Help: update lua.org links to be HTTPSBen Boeckel2024-01-011-1/+1
| | |/ / / | |/| | | | | | | | | | | | | This is now a permanent redirect, so update links accordingly.
* | | | | Merge topic 'doc-toolchains-apple'Craig Scott2024-01-011-4/+6
|\ \ \ \ \ | | |/ / / | |/| | / | |_|_|/ |/| | | | | | | | | | | | | | | 315cf74025 Help: Note CMAKE_IOS_INSTALL_COMBINED deprecation in toolchains example af2e4379fc Help: Fix typo not accounting for addition of visionOS Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9112
| * | | Help: Note CMAKE_IOS_INSTALL_COMBINED deprecation in toolchains exampleCraig Scott2023-12-301-3/+5
| | | |
| * | | Help: Fix typo not accounting for addition of visionOSCraig Scott2023-12-301-1/+1
| |/ /
* | | Merge topic 'package-dispatch-apple'Brad King2023-12-201-0/+7
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 4ac5a2f866 CMakePackageConfigHelpers: Add generate_apple_architecture_selection_file() b9f81ee9f9 CMakePackageConfigHelpers: Remove outdated documentation summary paragraph 68a03cf3d4 generate_apple_platform_selection_file: Add INSTALL_PREFIX option ff21f0f70f Tests: Verify generate_apple_platform_selection_file file paths Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9092
| * | | CMakePackageConfigHelpers: Add generate_apple_architecture_selection_file()Brad King2023-12-191-0/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a helper to select architecture-specific implementations of a package on an Apple-specific platform. Fixes: #25516
* | | | Merge topic 'add_test-CROSSCOMPILING_EMULATOR-exclusive'Brad King2023-12-204-0/+38
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ca5a300d7f add_test: Honor CROSSCOMPILING_EMULATOR only when cross-compiling Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8947
| * | | | add_test: Honor CROSSCOMPILING_EMULATOR only when cross-compilingRalf Habacker2023-12-194-0/+38
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add policy CMP0158 to provide compatibility for existing projects. Fixes: #23672
* | | | | Merge topic 'doc-typo-dep-provider-method'Brad King2023-12-201-1/+1
|\ \ \ \ \ | |_|/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | d0ab70d57d Help: Fix typo in dependency provider method keyword Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9079
| * | | | Help: Fix typo in dependency provider method keywordCraig Scott2023-12-151-1/+1
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The cmake.vim file is generated by scanning for keyword-like strings in the docs. Update the corresponding wrong entry there too directly for now, which will fix the wrong entry until the next full regeneration of the file. Fixes: #25503
* | | | Merge topic 'doc-fileapi-launchers'Brad King2023-12-191-23/+23
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6d962f3700 Help: Fix indentation level in fileapi docs for target attribute 'launchers' Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9084
| * | | | Help: Fix indentation level in fileapi docs for target attribute 'launchers'Ralf Habacker2023-12-181-23/+23
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The mentioned attribute is on the top level, not below the `install` attribute. This was missed in commit 80a64c9ce5 (fileapi: Add cross-compilation emulator to codemodel-v2, 2023-11-11). Issue: #25408
* | | | Help: Document Xcode project visibility constraints for embeddingCraig Scott2023-12-151-0/+16
|/ / / | | | | | | | | | Fixes: #22412
* | | Merge topic 'cmake-test-launcher'Brad King2023-12-1513-7/+94
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 88863d83d6 fileapi: Add test launcher to codemodel-v2 1ec0372ed4 add_test: Optionally use a launcher for tests running in-project targets 478a5f4e04 fileapi: Make launcher attribute 'arguments' optional b44e38a397 cmFileAPICodemodel: Add missing std::move() Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8963