summaryrefslogtreecommitdiffstats
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
...
| * | | Add CMAKE_MAXIMUM_RECURSION_DEPTH environment variableBrad King2023-03-131-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Extend the recursion limit controls added by commit a6982cff0d (cmMakefile: Impose maximum recursion limit, 2018-12-14, v3.14.0-rc1~82^2) with an environment variable that is used if the CMake variable of the same name is not set.
* | | | Merge topic 'support_cubin_fatbin_optix_cuda_output'Brad King2023-03-141-0/+3
|\ \ \ \ | |_|/ / |/| | | | | | | | | | | | | | | | | | | | | | | 2def6a874b CUDA: Add support for CUBIN, FATBIN, and OPTIXIR compilation Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8259
| * | | CUDA: Add support for CUBIN, FATBIN, and OPTIXIR compilationRobert Maynard2023-03-131-0/+3
| | | |
* | | | VS: Add policy to build custom commands concurrentlyBrad King2023-03-121-0/+1
| |_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In commit 33c15ae2b9 (VS: Build custom commands concurrently when possible, 2023-01-19, v3.26.0-rc1~56^2) we added `BuildInParallel` to custom commands in `.vcxproj` files, but that had to be reverted by commit abb1c12162 (VS: Revert "Build custom commands concurrently when possible", 2023-03-07, v3.26.0-rc6~3^2) because some projects may have custom commands that accidentally rely on serial execution in MSBuild. Add a policy to use `BuildInParallel` for custom commands in projects that have been updated to set the policy to `NEW`. Fixes: #18405
* | | FindCUDA: Add policy to remove this moduleBrad King2023-03-091-0/+1
| |/ |/| | | | | | | | | The `FindCUDA` module has been deprecated since CMake 3.10. Add a policy to pretend it doesn't exist in order to encourage projects to port away from it.
* | Apple: text-based stubs: manage imported configurations mappingMarc Chevrier2023-03-051-0/+2
| |
* | Merge topic 'doc-block'Brad King2023-03-031-0/+3
|\ \ | | | | | | | | | | | | | | | | | | 2931f078dc Help:cmake-language: note new block() command scope Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8276
| * | Help:cmake-language: note new block() command scopescivision2023-03-021-0/+3
| | |
* | | Merge topic 'TargetRunTimeDllDirs'Kyle Edwards2023-03-021-1/+17
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | a2c9c4f202 Add test for the new TARGET_RUNTIME_DLL_PATHS genex aa68de0a27 TARGET_RUNTIME_DLLS: minor refactoring of shared-check.cmake 2ce3d62ffb Help: add documentation for the new TARGET_RUNTIME_DLL_DIRS genex c351dcd967 TARGET_RUNTIME_DLL_DIRS: add the new genex to cmGeneratorExpressionNode 064c3244da TARGET_RUNTIME_DLLS: fix test for this genex Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: Alex <leha-bot@yandex.ru> Merge-request: !8247
| * | | Help: add documentation for the new TARGET_RUNTIME_DLL_DIRS genexAlexander Neundorf2023-02-261-1/+17
| | | |
* | | | Merge topic 'Apple-handle-Text-Stubs'Brad King2023-03-023-3/+254
|\ \ \ \ | |_|_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | ede33f30cf Apple: Handle generation and comsuption of text-based stubs (.tbd files) fcbd723a50 Enhance support functions Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Brad King <brad.king@kitware.com> Merge-request: !8204
| * | | Apple: Handle generation and comsuption of text-based stubs (.tbd files)Marc Chevrier2023-03-013-3/+254
| | | | | | | | | | | | | | | | Fixes: #24123
* | | | Dart,FindDart: Add policy to remove these modulesBrad King2023-02-281-0/+1
| | | | | | | | | | | | | | | | | | | | These modules and the "DART" tool they support have long been replaced by CTest.
* | | | Merge topic 'dll-name-soversion'Brad King2023-02-282-0/+2
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | a7f9c7da26 Add option to add SOVERSION to DLL names 9694504adc Tests: Simplify RunCMake.TargetArtifacts spec 3cd34eb279 Tests: Rename RunCMake.{ArtifactOutputDirs => TargetArtifacts} Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8021
| * | | Add option to add SOVERSION to DLL namesRalf Habacker2023-02-272-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Add variable/target property `[CMAKE_]DLL_NAME_WITH_SOVERSION`. Fixes: #24251 Signed-off-by: Ralf Habacker <ralf.habacker@freenet.de>
* | | | install(CODE|SCRIPT): Support $<INSTALL_PREFIX> genexKyle Edwards2023-02-241-2/+4
|/ / / | | | | | | | | | Fixes: #24534
* | | Merge topic 'PATH-genex-handle-list-of-paths'Brad King2023-02-241-17/+26
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | e395310a21 PATH-genex: handle lists for path decomposition and transformations Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Acked-by: scivision <michael@scivision.dev> Merge-request: !8238
| * | | PATH-genex: handle lists for path decomposition and transformationsMarc Chevrier2023-02-211-17/+26
| |/ / | | | | | | | | | Fixes: #24371
* | | find_package: Use <PACKAGENAME>_ROOT variables as search prefixesBrad King2023-02-231-0/+8
|/ / | | | | | | | | | | | | | | | | Extend commit eb35d8884b (find_package: Use PackageName_ROOT variables as search prefixes, 2018-03-15, v3.12.0-rc1~349^2) to also check upper-case `<PACKAGENAME>_ROOT` variables. Add policy `CMP0144` to enable the behavior in a compatible way. Fixes: #24403
* | Merge topic 'doco'Brad King2023-02-214-21/+23
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | 6f354a6d57 Help: ctest(1): emphasize the --test-dir option f0e60ea867 Help: cmake (1): put modern configure signature first Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Alex <leha-bot@yandex.ru> Merge-request: !8222
| * | Help: ctest(1): emphasize the --test-dir optionscivision2023-02-191-2/+3
| | | | | | | | | | | | | | | it seems few people know of this option and needlessly add extra shell commands to change directory.
| * | Help: cmake (1): put modern configure signature firstscivision2023-02-193-19/+20
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | recommend compact, most robust signature first. So many people are still using the multi-step pre-3.13 way of initializing a build. Rather than simply cmake -Bbuild which is one step instead of 3 just to configure a new project.
* | | Add variable CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLYAbdelmaged Khalifa2023-02-171-0/+1
|/ / | | | | | | | | | | | | Add CMake variable `CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY` to enable option `DEPENDS_EXPLICIT_ONLY` on all uses of `add_custom_command`. Fixes: #17097
* | Merge topic 'deprecate-extra-generators'Brad King2023-02-162-1/+7
|\ \ | | | | | | | | | | | | | | | | | | | | | ef5a4d964b Deprecate "extra" generators in favor of cmake-file-api(7) Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8211
| * | Deprecate "extra" generators in favor of cmake-file-api(7)Brad King2023-02-152-1/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The "extra" generators were created in CMake's early years to provide support for users of specific IDEs by directly generating their project files alongside make or ninja files. Nowadays the file-api provides a more generic, maintainable, well-tested, and robust way for IDEs to view CMake project build trees. Deprecate the legacy "extra" generators to encourage the corresponding IDEs to use the file-api. Fixes: #19090
* | | Help:cmake -E time: note overhead includedscivision2023-02-151-1/+1
|/ /
* | Help: cmake(1): sleep can have floating point valuescivision2023-02-141-2/+9
| |
* | Merge topic 'cmake-gui-browse-manual-page'Brad King2023-02-101-3/+5
|\ \ | | | | | | | | | | | | | | | | | | | | | b5383bc767 cmake-gui: Add optional filename argument to --browse-manual Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8190
| * | cmake-gui: Add optional filename argument to --browse-manualKyle Edwards2023-02-091-3/+5
| | |
* | | Merge topic 'doc-configure-log'Brad King2023-02-091-6/+12
|\ \ \ | |/ / |/| / | |/ | | | | | | 2311b0a7f7 Help: Clarify that the documented configure log location is not stable Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8191
| * Help: Clarify that the documented configure log location is not stableBrad King2023-02-091-6/+12
| | | | | | | | Issue: #23200
* | Merge topic 'target-runtime-dlls-doc'Kyle Edwards2023-02-091-3/+3
|\ \ | |/ | | | | | | | | | | e0335f5830 Help: Update $<TARGET_RUNTIME_DLLS> docs to use cmake -E copy -t Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8185
| * Help: Update $<TARGET_RUNTIME_DLLS> docs to use cmake -E copy -tKyle Edwards2023-02-081-3/+3
| | | | | | | | | | | | The -t argument was added to support using $<TARGET_RUNTIME_DLLS> in the case that no DLLs are needed. Update the documentation accordingly.
* | Merge topic 'KateImprovements'Brad King2023-02-071-0/+2
|\ \ | |/ |/| | | | | | | | | | | | | | | | | | | e7f7bff4f5 Kate: improve the way the VCS-specific files are searched 96389b4cd3 Kate: add support for hg and fossil 4c32623f5f Help: fix typo in docs for set_property() 9a7612d2d0 Kate: make it possible to force a mode for the "files" entry 8a7aa2642b Help: add documentation for Kate-related variable Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8154
| * Kate: make it possible to force a mode for the "files" entryAlexander Neundorf2023-02-061-0/+1
| | | | | | | | | | | | | | By default, kate will try to autodetect whether the project is a svn or git checkout or not. In case this does not give a satisfying result, the user can now set CMAKE_KATE_FILES_MODE to the mode he wants.
| * Help: add documentation for Kate-related variableAlexander Neundorf2023-02-031-0/+1
| |
* | Help: cmake (1): remove -E server as not availablescivision2023-02-061-4/+0
|/ | | | ... since CMake 3.20
* try_compile: Record propagated CMake variables in configure logBrad King2023-02-011-0/+8
| | | | | | | These provide more detailed information about how the test project was configured. Issue: #23200
* Help: mark the directory properties INTERPROCEDURAL_OPTIMIZATION as deprecatedAlexander Neundorf2023-01-311-2/+2
| | | | | These properties actually never existed, so move the documentation to "Deprecated" and refer to the target properties.
* Merge topic 'doc-rpath-features'Brad King2023-01-251-0/+3
|\ | | | | | | | | | | | | | | | | | | | | | | 434be1256e Help: improve docs for INSTALL_NAME_DIR f784c21567 Help: mention CMAKE_SKIP_RPATH in the RPATH docs 66ad61ba79 Help: improve documentation for BUILD_RPATH 25e7791dc1 Help: improve docs for INSTALL_RPATH 099292f123 Help: improve docs for rpath-related variables Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8073
| * Help: improve docs for INSTALL_NAME_DIRAlexander Neundorf2023-01-201-0/+3
| | | | | | | | | | | | | | INSTALL_NAME_DIR now mentions BUILD_WITH_INSTALL_NAME_DIR. The INSTALL_NAME_DIR, INSTALL_RPATH and $<TARGET_RUNTIME_DLLS:tgt> documentation now mention the other two platforms respectively, to make it easier for developers who are not familiar with all three platforms,
* | message: Add CONFIGURE_LOG mode to record a message in the configure logBrad King2023-01-181-0/+32
| | | | | | | | | | | | | | Provide a replacement for `file(APPEND .../CMake{Output,Error}.log)` that records messages in the configure log. Issue: #23200
* | Help: Document configure log behavior in try_compile and try_runBrad King2023-01-181-0/+4
| |
* | Merge topic 'configure-log'Brad King2023-01-171-2/+22
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 48292c8624 try_compile: Record stack of in-progess checks in configure log d4bf7d80c6 try_compile: Add a NO_LOG option to skip recording in the configure log 9d9e8450a8 try_compile: Add optional LOG_DESCRIPTION to record in configure log 65ed5c2ca8 try_compile: Report underlying error when COPY_FILE fails 0418efb7ad Tests: Add explicit ConfigureLog case to RunCMake.try_compile 189557bd74 cmake: Make entire in-progress check stack available internally 96ce3581ab Help: Clarify backtrace order in cmake-configure-log(7) Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8072
| * | try_compile: Record stack of in-progess checks in configure logBrad King2023-01-161-0/+13
| | | | | | | | | | | | | | | | | | | | | | | | Many `try_compile` and `try_run` calls occur inside check modules between `message(CHECK_START)` and `message(CHECK_{PASS,FAIL})` pairs. Add a field to configure log entries to report this context. Issue: #23200
| * | try_compile: Add optional LOG_DESCRIPTION to record in configure logBrad King2023-01-161-0/+6
| | | | | | | | | | | | Issue: #23200
| * | Help: Clarify backtrace order in cmake-configure-log(7)Brad King2023-01-131-2/+3
| | |
* | | Merge topic 'ctest-no-tests-action-env-var'Brad King2023-01-172-0/+6
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0661de58d8 ctest(1): Add CTEST_NO_TESTS_ACTION env var Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8044
| * | | ctest(1): Add CTEST_NO_TESTS_ACTION env varfriendlyanon2023-01-132-0/+6
| | |/ | |/| | | | | | | | | | This environment variable provides a default value for the --no-tests=<action> command line argument.
* | | Merge topic 'doc-header-only'Brad King2023-01-171-1/+1
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | 93696d0f2e Help: Restore cmake-buildsystem(7) header-only library example Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8071