summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'PATH-genex-handle-list-of-paths'Brad King2023-02-242-17/+31
|\ | | | | | | | | | | | | | | | | 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-212-17/+31
| | | | | | | | Fixes: #24371
* | Merge topic 'tutorial_dependency_inversion'Brad King2023-02-2481-516/+645
|\ \ | | | | | | | | | | | | | | | | | | | | | 8ddf32196c Tutorial: Refactor MathFunctions code Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !7789
| * | Tutorial: Refactor MathFunctions codeMarkus Ferrell2023-02-2381-516/+645
| | | | | | | | | | | | | | | | | | | | | Propagate the refactor in Step 10 MathFunctions through all of the steps. Use MathFunctions/MathFunctions.cxx instead of Tutorial.cxx to determine which sqrt library is called. Adds .h files which correspond to their .cxx files by name.
* | | find_package: Use <PACKAGENAME>_ROOT variables as search prefixesBrad King2023-02-237-2/+89
| | | | | | | | | | | | | | | | | | | | | | | | | | | 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
* | | Help: Document <PackageName>_ROOT variable ordering using an ordered listBrad King2023-02-232-26/+41
| |/ |/| | | | | Make room to add more steps in a documented order.
* | 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.
* | | Merge topic 'KateNinjaImprovements'Brad King2023-02-211-0/+3
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2b713b0f95 Kate: mention Ninja Multiconfig in the docs f6f8f89e6c Kate: support for the targets of multi config ninja 0429a37e48 Kate: enable the ninja multiconfig generator for kate Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8226
| * | | Kate: mention Ninja Multiconfig in the docsAlexander Neundorf2023-02-201-0/+3
| | | |
* | | | Merge topic 'ninja-custom-command-depends'Brad King2023-02-204-0/+19
|\ \ \ \ | |_|/ / |/| | | | | | | | | | | | | | | | | | | | | | | ea2a05f402 Add variable CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8220
| * | | Add variable CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLYAbdelmaged Khalifa2023-02-174-0/+19
| |/ / | | | | | | | | | | | | | | | | | | 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 'ci-linkcheck'Brad King2023-02-172-3/+3
|\ \ \ | |/ / |/| | | | | | | | | | | | | | | | | | | | | | | 0787148785 gitlab-ci: Report sphinx logs as artifacts of its lint job 14506f49a2 Utilities/Sphinx: Configure linkcheck allowed permanent redirects 3c5b34af9d Help: Replace links with their permanent redirects 1004be159f FindCUDAToolkit: Replace broken links to NVIDIA documentation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8210
| * | Help: Replace links with their permanent redirectsBrad King2023-02-172-3/+3
| | |
* | | Merge topic 'deprecate-extra-generators'Brad King2023-02-1610-2/+50
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-1510-2/+50
| |/ / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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
* | | Merge topic 'testdoc'Brad King2023-02-163-39/+35
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 6e71c31afd Help:add_test: emphasize important points Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8212
| * | | Help:add_test: emphasize important pointsscivision2023-02-153-39/+35
| |/ / | | | | | | | | | | | | | | | | | | * enable_testing must be called to enable testing * can only set properties on tests created in same directory * WILL_FAIL still fails on segfault and similar * compact wording
* | | Help:cmake -E time: note overhead includedscivision2023-02-151-1/+1
|/ /
* | Merge topic 'ninja-custom-command-depends'Brad King2023-02-152-1/+24
|\ \ | | | | | | | | | | | | | | | | | | 082ccd7530 add_custom_command: Add DEPENDS_EXPLICIT_ONLY option for Ninja Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8198
| * | add_custom_command: Add DEPENDS_EXPLICIT_ONLY option for NinjaAbdelmaged Khalifa2023-02-142-1/+24
| |/ | | | | | | | | | | | | | | | | Add option `DEPENDS_EXPLICIT_ONLY` to `add_custom_command` to indicate that implicit dependencies coming from users of the output are not needed, and only consider dependencies explicitly specified in the custom command. Fixes: #17097
* | Help: cmake(1): sleep can have floating point valuescivision2023-02-141-2/+9
| |
* | Help: math: note that floating point inputs are invalidscivision2023-02-141-1/+2
| |
* | Merge topic 'deprecate-pre-3.5'Brad King2023-02-131-0/+7
|\ \ | |/ |/| | | | | | | | | | | | | | | | | | | | | 3a4791548d Deprecate compatibility with CMake versions older than 3.5 1edf138506 Tests/RunCMake: Update cmake_minimum_required versions 65a1c379ee Tests/CTestTest*: Update cmake_minimum_required versions 589e6fdcd1 Tests: Update cmake_minimum_required versions in a few tests 3092b14ed0 Tests: Teach RunCMake to optionally ignore policy version deprecation warnings Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: scivision <michael@scivision.dev> Merge-request: !8192
| * Deprecate compatibility with CMake versions older than 3.5Brad King2023-02-111-0/+7
| | | | | | | | | | | | | | | | Issue a deprecation warning on calls to `cmake_minimum_required` or `cmake_policy` that set policies based on versions older than 3.5. Note that the effective policy version includes `...<max>` treatment. Update the check from commit 5845c218d7 (Deprecate compatibility with CMake versions older than 2.8.12, 2020-06-12, v3.19.0-rc1~629^2).
* | 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 'clarify-clang-tidy-export-fixes-doc'Brad King2023-02-091-6/+6
|\ \ \ | |/ / | | / | |/ |/| | | | | f9d9258d5c Help: Avoid making guarantees about <LANG>_CLANG_TIDY_EXPORT_FIXES_DIR Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8189
| * Help: Avoid making guarantees about <LANG>_CLANG_TIDY_EXPORT_FIXES_DIRKyle Edwards2023-02-091-6/+6
| | | | | | | | | | | | Rather than stating specifically which files may be written or deleted, simply state that CMake owns the directory and that a dedicated directory should be used for exporting the fixes.
| * Merge topic 'doc-find_package-root-case' into release-3.26Brad King2023-02-093-9/+10
| |\ | | | | | | | | | | | | | | | | | | 20e727a408 Help: Clarify that <PackageName>_ROOT variable names are case-preserved Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8182
* | \ Merge topic 'vs9-deprecate'Brad King2023-02-092-1/+14
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | d7f440c5db Deprecate Visual Studio 9 2008 generator Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8181
| * | | Deprecate Visual Studio 9 2008 generatorBrad King2023-02-082-1/+14
| | | | | | | | | | | | | | | | | | | | Update documentation to mark the generator deprecated. Add a warning at the end of generation plus an option to turn off the warning.
* | | | Merge topic 'doc-find_package-root-case'Brad King2023-02-093-9/+10
|\ \ \ \ | | |_|/ | |/| | | | | | | | | | | | | | | | | | 20e727a408 Help: Clarify that <PackageName>_ROOT variable names are case-preserved Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8182
| * | | Help: Clarify that <PackageName>_ROOT variable names are case-preservedBrad King2023-02-083-9/+10
| | | | | | | | | | | | | | | | | | | | The name comes from the case-preserved first argument to `find_package`.
* | | | 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 'doc-FetchContent-catch2' into release-3.26Brad King2023-02-081-1/+1
| |\ | | | | | | | | | | | | | | | | | | 6d48f48d5d FetchContent: Bump documented example Catch2 to v3.0.1 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8172
* | \ Merge topic 'feature/sphinx-linkcheck'Brad King2023-02-081-2/+2
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | 6789af36bf Help: Fix broken links found by `linkcheck` 8f4bd3bf7e ci: Check for broken links when build HTML manual Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8177
| * | | Help: Fix broken links found by `linkcheck`Alex Turbov2023-02-071-2/+2
| | | |
* | | | Merge topic 'doc-FetchContent-catch2'Brad King2023-02-081-1/+1
|\ \ \ \ | | |_|/ | |/| | | | | | | | | | | | | | | | | | 6d48f48d5d FetchContent: Bump documented example Catch2 to v3.0.1 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8172
| * | | FetchContent: Bump documented example Catch2 to v3.0.1Eisuke Kawashima2023-02-071-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | The previous Catch2 v2.13.4 does not compile on some platforms [1]. [1] https://github.com/catchorg/Catch2/issues/2326
* | | | Merge topic 'doc-cpack-generator-fields'Brad King2023-02-086-423/+491
|\ \ \ \ | |_|/ / |/| | / | | |/ | |/| | | | | | | | | | | | | | | | | | | | | | 4cc4be1414 Help: CPack FreeBSD Generator page use field lists 083a57550b Help: CPack DragNDrop Generator page use field lists 2c46fe7c96 Help: CPack Archive Generator page use field lists 5defbf7430 Help: CPack RPM Generator page use field lists 27d45be75d Help: CPack NuGet Generator page use field lists fbb5ac4735 Help: CPack DEB Generator page use field lists Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8134
| * | Help: CPack FreeBSD Generator page use field listsAlex Turbov2023-02-071-28/+28
| | |
| * | Help: CPack DragNDrop Generator page use field listsAlex Turbov2023-02-071-11/+21
| | |
| * | Help: CPack Archive Generator page use field listsAlex Turbov2023-02-071-23/+33
| | |
| * | Help: CPack RPM Generator page use field listsAlex Turbov2023-02-071-201/+244
| | |
| * | Help: CPack NuGet Generator page use field listsAlex Turbov2023-02-071-56/+57
| | |