summaryrefslogtreecommitdiff
path: root/Help/manual
Commit message (Collapse)AuthorAgeFilesLines
...
* | | | 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-181-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-183-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
| * | Help: Restore cmake-buildsystem(7) header-only library exampleBrad King2023-01-131-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since commit 4391913133 (Add INTERFACE libraries to generated buildsystem if they have SOURCES, 2020-07-20, v3.19.0-rc1~346^2~1) the "Eigen" example in the `cmake-buildsystem(7)` manual is supposed to show a header-only library in which the headers are attached as sources to be edited in IDEs. This was accidentally broken by commit 4b25a0d512 (Help/manual: Update header-only library example, 2022-04-22, v3.24.0-rc1~220^2) when updating the example to use a `FILE_SET`. Fixes: #24319
* | | Merge topic 'fea/add-copy_directory_if_different'Brad King2023-01-131-0/+10
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | c1170b5602 cmake: Add -E copy_directory_if_different Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8059
| * | | cmake: Add -E copy_directory_if_differentRobert Maynard2023-01-121-0/+10
| | |/ | |/| | | | | | | Fixes #21584
* | | FindUnixCommands: Deprecate in favor of cmake -EFeRD (Frank Dana)2023-01-121-1/+1
| | | | | | | | | | | | | | | | | | `${CMAKE_COMMAND} -E` subcommands are cross-platform replacements. Fixes: #24263
* | | Help: Move FindITK/FindVTK to deprecated listFeRD (Frank Dana)2022-12-211-2/+2
|/ / | | | | | | | | | | Both modules have actually been removed entirely, they exist in the Help directory only as "This module used to exist" placeholders.
* | Merge topic 'doc-SYSTEM'Craig Scott2022-12-191-8/+8
|\ \ | | | | | | | | | | | | | | | | | | dfab263825 Help: Clarify and update SYSTEM-related docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8027
| * | Help: Clarify and update SYSTEM-related docsCraig Scott2022-12-171-8/+8
| | |
* | | FileAPI: Add "configureLog" object kindBrad King2022-12-172-0/+49
| | | | | | | | | | | | | | | | | | | | | Provide clients with a way to get a known set of configure log event versions. Issue: #23200
* | | ConfigureLog: Version individual events instead of the whole logBrad King2022-12-161-21/+42
| | | | | | | | | | | | | | | | | | | | | | | | In order to support multiple log versions without buffering the entire log, move versioning to the level of individual events. Multiple versions of an event may then be logged consecutively. Issue: #23200
* | | ConfigureLog: Log try_compile and try_run checksMatthew Woehlke2022-12-161-3/+134
| | | | | | | | | | | | | | | | | | Add configure log events for `try_compile` and `try_run` results. Issue: #23200
* | | ConfigureLog: Add infrastructure for structured configure event loggingMatthew Woehlke2022-12-161-0/+102
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add infrastructure for a "configure log". Use YAML for a balance of machine- and human-readability to records details of configure-time events in a structured format. Teach the RunCMake test framework to support matching the configure log. Issue: #23200
* | | VS: Add a variable to report the Visual Studio version build numberBrad King2022-12-071-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | VS 2017 and above come with a Visual Studio Installer tool that tracks four-component Visual Studio version numbers. We already detect the VS version number because it is needed to make some generation decisions. Provide the number to projects in a `CMAKE_VS_VERSION_BUILD_NUMBER` variable so they can use it similarly. Fixes: #24230
* | | clang-tidy: add <LANG>_CLANG_TIDY_EXPORT_FIXES_DIR propertyKyle Edwards2022-12-062-0/+2
| | | | | | | | | | | | Fixes: #21362
* | | Merge topic 'help-remove-self-reference-links'Brad King2022-11-212-2/+2
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | eb77695e25 Help: clean up some minor typos c36910476a Help: remove links from pages to themselves 391c53a851 Help/prop_tgt/LINK_OPTIONS: fix `:genex:` reference de4909ea16 Help: fix some minor markup errors c42c77b020 Help/CMAKE_GLOBAL_AUTORCC_TARGET_NAME: fix link reference Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7940
| * | | Help: clean up some minor typosBen Boeckel2022-11-182-2/+2
| | | |
View Lorry Controller Status