summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'test-define-prop'Brad King2024-01-301-0/+36
|\ | | | | | | | | | | | | | | | | 6c3311d53b Help: Document property redefinition semantics 7aacae4e0e Tests: Add unit tests for property redefinition Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9136
| * Help: Document property redefinition semanticsFeRD (Frank Dana)2024-01-291-0/+36
| | | | | | | | | | | | | | | | | | Add a section to the `define_property()` documentation which details the behavior when attempting to redefine an existing property. (The command is silently ignored.) Provide an example using `get_property()` to examine a property definition created with `define_property()`.
* | Merge branch 'release-3.28'Brad King2024-01-291-3/+3
|\ \
| * | CMake 3.28.2v3.28.2Brad King2024-01-291-3/+3
| | |
| * | Merge topic 'cxxmodules-no-unity' into release-3.28Brad 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
* | \ \ Merge topic 'test-launcher-emulator-genex'Brad King2024-01-295-7/+20
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 13ece67a58 Add genex support to TEST_LAUNCHER and CROSSCOMPILING_EMULATOR b9ad73fcb2 cmTestGenerator: De-duplicate TEST_LAUNCHER and CROSSCOMPILING_EMULATOR impl Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9198
| * | | | Add genex support to TEST_LAUNCHER and CROSSCOMPILING_EMULATORBrad King2024-01-295-7/+20
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Evaluate generator expressions in these properties, as they apply to `add_test`, `add_custom_command`, and `add_custom_target`. The `CMAKE_CROSSCOMPILING_EMULATOR` variable's `try_run` behavior occurs at configure time and so cannot support generator expressions.
* | | | | Merge topic 'productbuild-domains-policy'Brad King2024-01-294-2/+45
|\ \ \ \ \ | |/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 339ae33e55 CPack: Change CPACK_PRODUCTBUILD_DOMAINS default to true (CMP0161) 4e7f2397e4 CPack: Clear temporary variable after it is no longer needed Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9197
| * | | | CPack: Change CPACK_PRODUCTBUILD_DOMAINS default to true (CMP0161)Craig Scott2024-01-284-2/+45
| | | | | | | | | | | | | | | | | | | | Fixes: #23351
* | | | | Merge topic 'doc-configure_file'Brad King2024-01-271-63/+77
|\ \ \ \ \ | |/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 682a513bbb Help: Organize configure_file documentation into sections Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Craig Scott <craig.scott@crascit.com> Merge-request: !9191
| * | | | Help: Organize configure_file documentation into sectionsBrad King2024-01-261-63/+77
| | | | |
* | | | | Merge topic 'ctest-tests-from-file'Brad King2024-01-263-0/+46
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 701029726f ctest_test: add options INCLUDE_FROM_FILE and EXCLUDE_FROM_FILE dbacc1d5a8 ctest: add command line option to exclude tests listed in a given file 022f20f663 ctest: add command line option to run the tests listed in a given file Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Alex <leha-bot@yandex.ru> Merge-request: !9128
| * | | | | ctest_test: add options INCLUDE_FROM_FILE and EXCLUDE_FROM_FILEAlex Neundorf2024-01-252-0/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | These options can be used to specify files which can be used to restrict the set of tests that will be executed. Fixes: #25455
| * | | | | ctest: add command line option to exclude tests listed in a given fileAlex Neundorf2024-01-252-1/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add `--exclude-from-file <filename>` to exclude the tests listed in the given file. Issue: #25455
| * | | | | ctest: add command line option to run the tests listed in a given fileAlex Neundorf2024-01-252-0/+17
| |/ / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add `--tests-from-file <filename>` to run only the tests listed in the given file. The test names must match exactly, no regexps or something. The listed tests can still be filtered with a regexp using -R. Issue: #25455
* | | | | IntelLLVM: support marking include paths as SYSTEM directoriesBen Boeckel2024-01-241-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Also learn how to suppress warnings when possible. See: https://discourse.cmake.org/t/icx-on-windows-supports-external-i/8739
* | | | | Merge topic 'validate_read-only_target_properties'Brad King2024-01-242-0/+40
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0cfd8fe8ad cmTarget: Don't allow setting read-only properties Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9133
| * | | | | cmTarget: Don't allow setting read-only propertiesRobert Maynard2024-01-232-0/+40
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Ensure that all documented read-only target properties now produce errors when trying to set.
* | | | | | Merge topic 'cuda-clang-windows'Brad King2024-01-231-0/+5
|\ \ \ \ \ \ | |_|/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 88c740462c CUDA/Clang: Add support for MSVC ABI on Windows using GNU-like frontend Acked-by: Kitware Robot <kwrobot@kitware.com> Reviewed-by: Raul Tambre <raul@tambre.ee> Merge-request: !9172
| * | | | | CUDA/Clang: Add support for MSVC ABI on Windows using GNU-like frontendBrad King2024-01-221-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | Fixes: #20776
* | | | | | MSVC: Teach find_library to consider the 'libfoo.a' naming conventionBrad King2024-01-191-0/+7
|/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When targeting the GNU ABI, we consider `.a` libraries first but also accept `.lib`. For symmetry, when targeting the MSVC ABI, we now consider `.lib` first but also accept `.a`. This adds support for meson-generated static libraries, which are named with the pattern `lib${foo}.a`: * https://mesonbuild.com/FAQ.html#why-does-building-my-project-with-msvc-output-static-libraries-called-libfooa Note that this was previously attempted by * commit be848a71b0 (MSVC: Teach find_library to consider the 'libfoo.a' naming convention, 2022-09-19, v3.25.0-rc1~111^2) but was reverted by * commit 955d6245c1 (MSVC: Revert "Teach find_library to consider the 'libfoo.a' naming convention", 2022-11-28, v3.25.1~6^2) due to problems finding GNU ABI libraries in PATH-derived prefixes. Since then, * commit 0a81110b84 (find_(library|file|path): Drop PATH-derived search prefixes, 2023-09-14, v3.28.0-rc1~91^2) removed the problematic search paths, so we can restore this change. Fixes: #23975
* | | | | Help: Document {CTEST,CMAKE_BUILD}_PARALLEL_LEVEL equivalent command-linescivision2024-01-182-2/+10
| | | | | | | | | | | | | | | | | | | | | | | | | Clarify that the `--parallel` option isn't needed when these env. variables are set to a finite integer.
* | | | | Merge topic 'autogen-exe-per-config'Brad King2024-01-184-0/+34
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 596e84b0d5 NinjaMultiConfig: Update tests for the new dependency change 7c39dabdbc Autogen: AUTO*_EXECUTABLE: add support for per-config values Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8919
| * | | | | Autogen: AUTO*_EXECUTABLE: add support for per-config valuesOrkun Tokdemir2024-01-174-0/+34
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Per-config values were added to `AUTO*_EXECUTABLE`. * Dependency order was refactored for `cmake_autogen` and `cmake_autorcc` to avoid unnecessary rebuilds. * A new parameter was added for `cmake_autogen` and `cmake_autorcc` to specify the config name of the `auto*_executable` to be used. * Add `AUTOGEN_BETTER_GRAPH_MULTI_CONFIG` target property to change the behavior of the dependency graph. * The timestamp target is split into three targets for per-config to avoid redundant `mocs_compilation` builds when `AUTOGEN_BETTER_GRAPH_MULTI_CONFIG` is ON * Per-config `DEP_FILE_RULE_NAME` values were added to `AutogenInfo.json` for `Multi-Config` usage. * Some functions were refactored to avoid code duplication. This commit reimplements fddd0f0443b4ce81d61f15ee1b2f13105967b25a Fixes: #20074
* | | | | | Merge topic 'cmake-language-exit-code'Brad King2024-01-172-0/+28
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 1bb1769235 cmake_language: Add EXIT subcommand 4f160f7906 cmakemain: Return the SCRIPT_MODE exit code if it was set b62dcbf5d2 cmMakefile: check cmake script mode exit code after command 3d9d504646 cmMakefile: Store the exit code from cmExecutionStatus to cmake instance 9f6c937408 Source/cmake.h: Add ScriptModeExitCode for proper storing exit code 1082b9cb9a cmExecutionStatus: Add ability to set optional custom exit code Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: Leonid Pospelov <pospelovlm@yandex.ru> Acked-by: NoMaY (a user of Renesas Rulz Japanese Forum) <nomay-jp@outlook.com> Merge-request: !8228
| * | | | | | 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
generated by cgit v0.12 at 2025-01-28 20:04:41 (GMT)