summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'smart-wrap-signatures'Brad King2023-03-141-0/+17
|\ | | | | | | | | | | | | 39ecaa5da1 Utilities/Sphinx: Improve word wrap of signatures Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8317
| * Utilities/Sphinx: Improve word wrap of signaturesMatthew Woehlke2023-03-131-0/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Implement logic to support several styles of parsing in the new signature directive that control where line breaks are allowed in a signature. The default is 'smart', which forbids breaks inside of square- or angle-brackets. The 'verbatim' option forbids all breaks. In all cases, breaks are always allowed where a newline appears in the source. This seems to Just Work for most writers, but HTML needs some special handling that is accomplished by a new CSS rule and assigning the 'nbsp' class to spaces that are not allowed to break. (ROFF's line wrapping is rather unfortunate here, as it prefers splitting and hyphenating words rather than breaking at a space.)
* | Merge topic 'genex-explicit-target'Brad King2023-03-142-0/+5
|\ \ | | | | | | | | | | | | | | | | | | | | | 2e37a20f02 Utilities/Sphinx: Allow explicit target for genex Acked-by: Kitware Robot <kwrobot@kitware.com> Reviewed-by: Raul Tambre <raul@tambre.ee> Merge-request: !8321
| * | Utilities/Sphinx: Allow explicit target for genexMatthew Woehlke2023-03-132-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Split the genex directive into its own class, allowing a slight simplification of CMakeObject. Add ability to specify an explicit target name for the same. Use this to provide a target for the `$<TARGET_PROPERTY:prop>` generator expression which is otherwise missing one (due to overlap with `$<TARGET_PROPERTY:tgt,prop>`). With this one can write: :genex:`$<TARGET_PROPERTY:prop> <TARGET_PROPERTY:prop>` to link the second variant. Fixes: #24573
* | | Merge topic 'recursion-limit'Brad King2023-03-143-0/+13
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 49167cf68f Source: Adjust stack sizes and recursion limits to work together 9504cef8c4 Tests: Allow RunCMake.MaxRecursionDepth to test public-facing default limit 60ef076bac find_package: Enforce maximum nesting depth below maximum recursion depth 89b69bf1ad Add CMAKE_MAXIMUM_RECURSION_DEPTH environment variable 395895bda7 cmMakefile: Factor out helper to get recursion depth limit 88bc8dfc14 cmMakefile: Store recursion depth limit as size_t fcad8d0630 cmMakefile: Improve parsing of CMAKE_MAXIMUM_RECURSION_DEPTH variable 497f7d5c1a Tests: Simplify option passing to RunCMake.MaxRecursionDepth cases Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8307
| * | | Add CMAKE_MAXIMUM_RECURSION_DEPTH environment variableBrad King2023-03-133-0/+13
| | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-145-0/+59
|\ \ \ \ | |_|/ / |/| | | | | | | | | | | | | | | | | | | | | | | 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-135-0/+59
| | | |
* | | | Merge topic 'vs-BuildInParallel'Brad King2023-03-133-0/+30
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 7a7793e6d7 FindCUDA: Disallow with CMP0147 under Visual Studio d6353e74b4 VS: Add policy to build custom commands concurrently Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8314
| * | | | VS: Add policy to build custom commands concurrentlyBrad King2023-03-123-0/+30
| | |_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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
* | | | Merge topic 'findopengl-gles'Brad King2023-03-131-0/+5
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | beb0a56c86 FindOpenGL: support finding GLES2 and GLES3 Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: Alex <leha-bot@yandex.ru> Merge-request: !8309
| * | | FindOpenGL: support finding GLES2 and GLES3Jaswant Panchumarti2023-03-101-0/+5
| | |/ | |/| | | | | | | | | | This also makes the EGL component not GLVND-specific, so documentation and tests are updated accordingly.
* | | Merge topic 'signature-refs'Brad King2023-03-101-3/+3
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | cc21d0e478 Utilities/Sphinx: Make signatures linkable 37e015d4a6 Utilities/Sphinx: Refactor Sphinx reference recording Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8305
| * | | Utilities/Sphinx: Make signatures linkableMatthew Woehlke2023-03-091-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add signatures to the collection of observed objects (which can be referenced elsewhere). Don't automatically strip parameters from a :command: reference, as these may now link signatures. (Do, however, munge them into 'text <ref>' form if they aren't already, as not doing so adds an extra '()' for some reason.) Correspondingly, change xref resolution to try to match 'command' when a ref like 'command(args)' is not matched, so that existing links to commands that have not been converted to use the new signature directive don't immediately break.
* | | | Merge topic 'cxx-module-extensions'Brad King2023-03-101-0/+5
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 45d1925efc Treat '.ccm', '.cxxm', and '.c++m' files as C++ sources 8c96d145c1 Tests/RunCMake: Match 'Tried extensions' output more robustly Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !8308
| * | | | Treat '.ccm', '.cxxm', and '.c++m' files as C++ sourcesBrad King2023-03-091-0/+5
| | |/ / | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | These extensions are used by convention for C++ module interface units with Clang. For now, do not add any tests using these extensions. Very few compilers recognize them as C++ sources. Tests can be added later as part of C++ modules support.
* | | | FindCUDA: Add policy to remove this moduleBrad King2023-03-093-0/+36
|/ / / | | | | | | | | | | | | | | | 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.
* | | Merge topic 'FindwxWidgets-imported-target'Brad King2023-03-091-0/+4
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | e36e455b7c FindwxWidgets: Add an imported target 42c84b1e2e ci: Add wxWidgets to Debian and Fedora base images Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Merge-request: !8289
| * | | FindwxWidgets: Add an imported targetCheesyNacho102023-03-081-0/+4
| | | |
* | | | Merge topic 'tutorial_refactor_cmake_scripts'Brad King2023-03-0921-114/+272
|\ \ \ \ | |/ / / |/| | | | | | | | | | | | | | | | | | | | | | | e1f2b35723 Tutorial: Refactor MakeTable commands into MakeTable.cmake Acked-by: Kitware Robot <kwrobot@kitware.com> Tested-by: buildbot <buildbot@kitware.com> Merge-request: !8249
| * | | Tutorial: Refactor MakeTable commands into MakeTable.cmakeMarkus Ferrell2023-03-0721-114/+272
| | | |
* | | | Merge branch 'release-3.25'Brad King2023-03-081-0/+7
|\ \ \ \
| * | | | CMake 3.25.3v3.25.3Brad King2023-03-081-0/+7
| | | | |
| * | | | Merge branch 'release-3.24' into release-3.25Brad King2023-03-081-0/+7
| |\ \ \ \
* | \ \ \ \ Merge branch 'release-3.24'Brad King2023-03-081-0/+7
|\ \ \ \ \ \ | | |/ / / / | |/| | | |
| * | | | | CMake 3.24.4v3.24.4Brad King2023-03-081-0/+7
| | | | | |
* | | | | | Merge topic 'find_cudatoolkit_add_cudla_targets'Brad King2023-03-081-0/+4
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 21b102c77d FindCUDAToolkit: Add support for finding Tegra cudla library Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8295
| * | | | | | FindCUDAToolkit: Add support for finding Tegra cudla libraryRobert Maynard2023-03-071-0/+4
| | |_|_|/ / | |/| | | | | | | | | | | | | | | | Fixes #24575
* | | | | | Help: Use signature directive for 'if' commandBrad King2023-03-071-70/+90
| | | | | |
* | | | | | Help: Improve sentence structure around "if so"Brad King2023-03-071-6/+6
| | | | | |
* | | | | | Help: Add internal cross-references to 'if' command docsBrad King2023-03-071-12/+14
| | | | | |
* | | | | | Help: Indent 'if' command docs more consistentlyBrad King2023-03-071-102/+102
|/ / / / /
* | | | | Merge topic 'improve-doc-signatures'Brad King2023-03-073-534/+561
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 533ebb072b Help: Use signature directive for string command cd33f461a6 Help: Use signature directive for cmake_language command 74e3c1d313 Utilities/Sphinx: Add a directive to document command signatures c09b760484 Utilities/Sphinx: Drop commented-out code from cmake domain impl 6e85ad7f8b Help/dev: Add per-directive sections in CMake Documentation Guide Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8243
| * | | | | Help: Use signature directive for string commandMatthew Woehlke2023-03-061-330/+256
| | | | | |
| * | | | | Help: Use signature directive for cmake_language commandMatthew Woehlke2023-03-061-166/+153
| | | | | |
| * | | | | Utilities/Sphinx: Add a directive to document command signaturesMatthew Woehlke2023-03-031-13/+82
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Add a `signature` directive to offer a CMake version of Sphinx's `function` directive, similar to that found in other domains (py, cpp, etc.). Like others, this takes one or more signatures as arguments and creates dt/dd nodes from the signatures and the directive contents.
| * | | | | Help/dev: Add per-directive sections in CMake Documentation GuideBrad King2023-02-241-25/+70
| | | | | |
* | | | | | Merge topic 'Apple-text-Stubs-imported-configurations'Brad King2023-03-062-1/+5
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2e24123186 Apple: text-based stubs: manage imported configurations mapping Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8283
| * | | | | | Apple: text-based stubs: manage imported configurations mappingMarc Chevrier2023-03-052-1/+5
| | | | | | |
* | | | | | | Merge topic 'doc-CMAKE_NINJA_OUTPUT_PATH_PREFIX'Brad King2023-03-061-13/+24
|\ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | dbcae48e3a Help: Clarify usage of CMAKE_NINJA_OUTPUT_PATH_PREFIX Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8284
| * | | | | | | Help: Clarify usage of CMAKE_NINJA_OUTPUT_PATH_PREFIXBrad King2023-03-031-13/+24
| |/ / / / / / | | | | | | | | | | | | | | | | | | | | | Issue: #24566
* | | | | | | Merge topic 'clang-16-cxx-modules'Brad King2023-03-061-11/+30
|\ \ \ \ \ \ \ | |/ / / / / / |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 3fe8e33f27 Clang: Record Clang 16.0 flags for our experimental C++ modules support Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: scivision <michael@scivision.dev> Acked-by: Alex <leha-bot@yandex.ru> Merge-request: !8285
| * | | | | | Clang: Record Clang 16.0 flags for our experimental C++ modules supportBrad King2023-03-031-11/+30
| | | | | | | | | | | | | | | | | | | | | | | | | | | | LLVM/Clang 16.0 now contains official support for what CMake needs.
* | | | | | | 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 'check-curses-min-cmake' into release-3.26Brad King2023-03-011-0/+1
| |\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | d70582eed8 ccmake: Update minimum required version of CMake for curses check Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8272
* | \ \ \ \ \ \ Merge topic 'doc-IMPORTED_CONFIGURATIONS'Brad King2023-03-032-8/+26
|\ \ \ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 8adcb73956 Help:IMPORTED_CONFIGURATIONS: Mention relation to IMPORTED_LOCATION e1032a22eb Help:IMPORTED_IMPLIB: Mention IMPORTED_IMPLIB_<CONFIG> variant Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !8281
| * | | | | | | | Help:IMPORTED_CONFIGURATIONS: Mention relation to IMPORTED_LOCATIONBrad King2023-03-021-8/+17
| | | | | | | | |
| * | | | | | | | Help:IMPORTED_IMPLIB: Mention IMPORTED_IMPLIB_<CONFIG> variantBrad King2023-03-021-0/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is already done in `IMPORTED_LOCATION` documentation.
* | | | | | | | | 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