summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
...
* | enable_language(): Fail if called before project()Craig Scott2024-04-021-0/+1
| | | | | | | | Fixes: #25550
* | Merge topic 'add_library-no-static-fallback'Brad King2024-04-011-0/+1
|\ \ | | | | | | | | | | | | | | | | | | | | | a61c9afdf8 add_library: Reject shared libraries on platforms that do not support them Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9347
| * | add_library: Reject shared libraries on platforms that do not support themAsit Dhal2024-03-291-0/+1
| | | | | | | | | | | | | | | | | | Add policy CMP0164 to provide compatibility. Fixes: #25759
* | | file(DOWNLOAD|UPLOAD): Add CMAKE_TLS_VERIFY environment variableBrad King2024-03-301-0/+1
|/ / | | | | | | Issue: #23608
* | CMP0163: Make GENERATED source file property globally visibleDeniz Bahadir2024-03-291-0/+1
|/ | | | | | | | | | | | | | | This was originally attempted by policy CMP0118, but its implementation did not cover all intended use cases. We fixed its documentation in commit 1dabbbb5e0 (CMP0118: Revise documentation to describe actual behavior, 2024-03-20). Add new policy CMP0163 to cover the remaining use cases. In particular, make the `GENERATED` property visible to `get_property` calls in other directories. In order to capture the original intention of CMP0118, define CMP0163's NEW behavior to also imply CMP0118's NEW behavior. Fixes: #25437 Fixes: #25058
* Help: cmake(1) --toolchain path relativescivision2024-03-221-1/+3
| | | | | | other cmake(1) options are relative to cwd. It is surprising enough that --toolchain is relative to -B or -S that it's good to call it out here too.
* Merge topic 'doc-CMP0118'Brad King2024-03-221-1/+1
|\ | | | | | | | | | | | | | | | | 1dabbbb5e0 CMP0118: Revise documentation to describe actual behavior d2f5b79795 CMP0118: Fix some tests and add more tests Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !9358
| * CMP0118: Revise documentation to describe actual behaviorDeniz Bahadir2024-03-211-1/+1
| | | | | | | | | | | | | | | | The policy was originally intended to make the `GENERATED` source file property globally visible, but the implementation didn't fully achieve that goal. Revise the documentation to describe what it actually does. Issue: #25437
* | Merge topic 'fileapi-provide-glob-dependent'Brad King2024-03-211-1/+49
|\ \ | |/ |/| | | | | | | | | | | | | 6116bcb066 fileapi: Add CONFIGURE_DEPENDS glob info to cmakeFiles object f578515d02 cmGlobCacheEntry: Add helper to carry CONFIGURE_DEPENDS glob cache arguments Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !9348
| * fileapi: Add CONFIGURE_DEPENDS glob info to cmakeFiles objectArctic Lampyrid2024-03-191-1/+49
| | | | | | | | | | Fixes: #25668 Co-authored-by: Brad King <brad.king@kitware.com>
* | Merge topic 'doc-release-3.29-typos'Brad King2024-03-191-1/+1
|\ \ | |/ |/| | | | | | | | | | | eceb368ccc Help: Fix typos in 3.29 docs 31fb693d06 Help: Fix typos and grammar in pre-3.29 docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9353
| * Help: Fix typos and grammar in pre-3.29 docsCraig Scott2024-03-191-1/+1
| |
| * Merge topic 'ctest-j-default' into release-3.29Brad King2024-03-111-7/+17
| |\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5de1e21659 ctest: Allow passing -j without value to choose a contextual default bbcbcff7d9 cmCTestMultiProcessHandler: Modernize member initialization 7457b474a1 Tests: Remove unnecessary parallel suppression from CTestCoverageCollectGCOV ae69801d96 Tests: Convert CTestTestSkipReturnCode to RunCMake.ctest_test case 30dda49416 Tests: Convert CTestTestSerialOrder to RunCMake.ctest_test case Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: scivision <michael@scivision.dev> Merge-request: !9315
* | | ctest: Add explicit options for TLS versionBrad King2024-03-122-0/+10
| | | | | | | | | | | | | | | | | | | | | Add a dedicated `TLSVersion` ctest option and a `CTEST_TLS_VERSION` variable to control it. Issue: #25701
* | | ctest: Add explicit options for TLS server verificationBrad King2024-03-122-0/+14
| | | | | | | | | | | | | | | | | | Add a dedicated `TLSVerify` ctest option and a `CTEST_TLS_VERIFY` variable to control it. Deprecate `CurlOptions` because it exposes internal implementation details.
* | | Help: Format ctest(1) CurlOptions values as a definition listBrad King2024-03-121-2/+9
| | |
* | | Merge topic 'ctest-j-default'Brad King2024-03-111-7/+17
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5de1e21659 ctest: Allow passing -j without value to choose a contextual default bbcbcff7d9 cmCTestMultiProcessHandler: Modernize member initialization 7457b474a1 Tests: Remove unnecessary parallel suppression from CTestCoverageCollectGCOV ae69801d96 Tests: Convert CTestTestSkipReturnCode to RunCMake.ctest_test case 30dda49416 Tests: Convert CTestTestSerialOrder to RunCMake.ctest_test case Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: scivision <michael@scivision.dev> Merge-request: !9315
| * | ctest: Allow passing -j without value to choose a contextual defaultBrad King2024-03-101-7/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Under job server integration, added by commit 80fe56c481 (ctest: Add support for running under a make job server on POSIX systems, 2023-11-15, v3.29.0-rc1~324^2), use a very high default so that parallelism is effectively limited only by available job server tokens. Otherwise, choose a default limit based on the number of processors. Also allow passing `0` to specify unbounded parallelism. Fixes: #25739
* | | Merge topic 'ctest-tests-from-file'Brad King2024-03-111-6/+6
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | 170ec48601 Help: Improve ctest tests-from-file documentation wording and wrapping 1a4837641e ctest: Remove unnecessary and ambiguous tests-from-file comment syntax d52c66bfb3 ctest: Honor tests-from-file options with empty input 8673264e25 Tests: Make ctest tests-from-file expected output more precise Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9322
| * | Help: Improve ctest tests-from-file documentation wording and wrappingBrad King2024-03-081-4/+4
| | |
| * | ctest: Remove unnecessary and ambiguous tests-from-file comment syntaxBrad King2024-03-081-2/+2
| |/ | | | | | | | | | | | | | | Test names can contain `#`. Since we ignore lines that do not match any test names anyway, "commenting" can still work without explicit syntax. Also drop whitespace trimming for similar reasons. Fixes: #25741
* | file(DOWNLOAD|UPLOAD): Add CMAKE_TLS_VERSION environment variableBrad King2024-02-281-0/+1
| | | | | | | | Issue: #25701
* | file(DOWNLOAD|UPLOAD): Add CMAKE_TLS_VERSION variableBrad King2024-02-281-0/+1
| | | | | | | | Issue: #25701
* | Merge topic 'vs-UseDebugLibraries'Brad King2024-02-231-0/+8
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 721d8b192a VS: Add UseDebugLibraries to vcxproj files by default 47136b6959 VS: Suppress more MSBuild defaults affected by UseDebugLibraries 82a174182a cmVisualStudioGeneratorOptions: Add UsingDebugRuntime method f498032141 cmVisualStudioGeneratorOptions: Rename {IsDebug => UsingDebugInfo} Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !9275
| * | VS: Add UseDebugLibraries to vcxproj files by defaultBrad King2024-02-221-0/+8
| | | | | | | | | | | | | | | | | | | | | Use heuristics to select a reasonable value. Add policy CMP0162 to provide compatibility with existing projects. Fixes: #25327
* | | Merge topic 'preset-includes-macro-expansion'Brad King2024-02-222-1/+24
|\ \ \ | |/ / |/| | | | | | | | | | | | | | 1a38ffc656 presets: Expand more macros in the `include` directive Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !9108
| * | presets: Expand more macros in the `include` directiveCristian Le2024-02-212-1/+24
| | | | | | | | | | | | Signed-off-by: Cristian Le <cristian.le@mpsd.mpg.de>
* | | VS: Add [CMAKE_]VS_USE_DEBUG_LIBRARIES options to control UseDebugLibrariesBrad King2024-02-192-0/+2
|/ / | | | | | | | | | | | | This indicates to MSBuild which configurations are considered debug configurations. This is useful for reference both by humans and tools. Issue: #25327
* | GeneratorExpression: Add $<QUOTE> generator expressionRobert Maynard2024-02-141-0/+7
|/ | | | | | Support inserting '"' literals in generator expressions Fixes #20869
* TIClang: Add support for TI Clang-based compilers, including tiarmclangAlan Phipps2024-02-091-0/+1
| | | | | | | | Add TIClang compiler ID and support in compiler modules. Update documentation. Add rudimentary RunCMake test for TIClang to test basic functionality. Fixes: #24619
* Autogen: Update DocumentationOrkun Tokdemir2024-02-081-25/+49
| | | | | | | * Add Qt 6 to documentation * Add explanation about `<ORIGIN>_autogen_timestamp_deps` Fixes: #25201
* cmake: Allow CMAKE_INSTALL_PREFIX to be set by environment variableSilvio Traversaro2024-01-301-0/+1
| | | | Fixes: #25023
* CPack: Change CPACK_PRODUCTBUILD_DOMAINS default to true (CMP0161)Craig Scott2024-01-281-0/+1
| | | | Fixes: #23351
* Merge topic 'ctest-tests-from-file'Brad King2024-01-261-0/+24
|\ | | | | | | | | | | | | | | | | | | 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: add command line option to exclude tests listed in a given fileAlex Neundorf2024-01-251-0/+12
| | | | | | | | | | | | | | 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-251-0/+12
| | | | | | | | | | | | | | | | 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
* | Merge topic 'validate_read-only_target_properties'Brad King2024-01-241-0/+1
|\ \ | |/ |/| | | | | | | | | | | 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-231-0/+1
| | | | | | | | | | Ensure that all documented read-only target properties now produce errors when trying to set.
* | Merge topic 'autogen-exe-per-config'Brad King2024-01-182-0/+2
|\ \ | |/ |/| | | | | | | | | | | | | 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-172-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | * 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 'file-strings-regex-match'Brad King2024-01-111-0/+1
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | 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-091-0/+1
| |/ | | | | | | Signed-off-by: Cristian Le <cristian.le@mpsd.mpg.de>
* | Merge topic 'cxxmodules-no-unity'Brad King2024-01-101-0/+4
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-051-0/+4
| | |
* | | Merge topic 'ctest-cli-http-headers'Brad King2024-01-091-0/+10
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-081-0/+10
| | | | | | | | | | | | | | | | Add ability to specify HTTP headers via `ctest -T Submit`.
* | | | 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 '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