Matthew Woehlke
cc21d0e478
Utilities/Sphinx: Make signatures linkable
...
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.
2023-03-09 11:32:07 -05:00
Brad King
3d6075da4d
Merge topic 'improve-doc-signatures'
...
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
2023-03-07 08:49:30 -05:00
Matthew Woehlke
533ebb072b
Help: Use signature directive for string command
2023-03-06 09:52:52 -05:00
Matthew Woehlke
cd33f461a6
Help: Use signature directive for cmake_language command
2023-03-06 09:52:12 -05:00
Brad King
6b08358e17
Merge topic 'Apple-text-Stubs-imported-configurations'
...
2e24123186 Apple: text-based stubs: manage imported configurations mapping
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8283
2023-03-06 09:03:48 -05:00
Brad King
2e45df3168
Merge topic 'doc-CMAKE_NINJA_OUTPUT_PATH_PREFIX'
...
dbcae48e3a Help: Clarify usage of CMAKE_NINJA_OUTPUT_PATH_PREFIX
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8284
2023-03-06 09:00:26 -05:00
Brad King
617b8df7cf
Merge topic 'clang-16-cxx-modules'
...
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
2023-03-06 08:59:21 -05:00
Marc Chevrier
2e24123186
Apple: text-based stubs: manage imported configurations mapping
2023-03-05 14:39:56 +01:00
Matthew Woehlke
74e3c1d313
Utilities/Sphinx: Add a directive to document command signatures
...
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.
2023-03-03 17:05:02 -05:00
Brad King
dbcae48e3a
Help: Clarify usage of CMAKE_NINJA_OUTPUT_PATH_PREFIX
...
Issue: #24566
2023-03-03 12:48:35 -05:00
Brad King
3fe8e33f27
Clang: Record Clang 16.0 flags for our experimental C++ modules support
...
LLVM/Clang 16.0 now contains official support for what CMake needs.
2023-03-03 12:44:53 -05:00
Brad King
1150418769
Merge topic 'doc-block'
...
2931f078dc Help:cmake-language: note new block() command scope
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8276
2023-03-03 09:21:17 -05:00
Brad King
10f318326f
Merge topic 'doc-IMPORTED_CONFIGURATIONS'
...
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
2023-03-03 09:10:54 -05:00
Kyle Edwards
def618f1ae
Merge topic 'TargetRunTimeDllDirs'
...
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
2023-03-02 16:28:30 -05:00
Brad King
8adcb73956
Help:IMPORTED_CONFIGURATIONS: Mention relation to IMPORTED_LOCATION
2023-03-02 15:25:32 -05:00
Brad King
e1032a22eb
Help:IMPORTED_IMPLIB: Mention IMPORTED_IMPLIB_<CONFIG> variant
...
This is already done in `IMPORTED_LOCATION` documentation.
2023-03-02 15:25:00 -05:00
scivision
2931f078dc
Help:cmake-language: note new block() command scope
2023-03-02 10:34:56 -05:00
Brad King
1d7fb31778
Merge topic 'Apple-handle-Text-Stubs'
...
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
2023-03-02 09:53:03 -05:00
Brad King
532ca3e7c7
Merge topic 'check-curses-min-cmake'
...
d70582eed8 ccmake: Update minimum required version of CMake for curses check
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8272
2023-03-01 09:36:36 -05:00
Brad King
fd05b428eb
Merge topic 'check-curses-min-cmake' into release-3.26
...
d70582eed8 ccmake: Update minimum required version of CMake for curses check
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8272
2023-03-01 09:36:35 -05:00
Brad King
0c30af2753
Merge topic 'remove-dart-modules'
...
2e469212c8 Dart,FindDart: Add policy to remove these modules
6dd2948b4b Tests: Port "testing" test from Dart module to CTest module
1f5ff4d131 Merge branch 'upstream-KWSys' into remove-dart-modules
ec3652a0bd KWSys 2023-02-28 (68534a6a)
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Reviewed-by: Ben Boeckel <ben.boeckel@kitware.com >
Merge-request: !8265
2023-03-01 09:21:03 -05:00
Brad King
d70582eed8
ccmake: Update minimum required version of CMake for curses check
...
This should have been part of commit d6b811fb82 (Require CMake 3.13+ to
configure CMake itself, 2022-02-22, v3.24.0-rc1~605^2~1).
2023-03-01 09:15:38 -05:00
Brad King
5691e7e900
Merge topic 'try-doc'
...
b6cfbe7b17 Help:try_{compile,run}: clarify, encourage new syntax
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8262
2023-03-01 09:11:55 -05:00
Marc Chevrier
ede33f30cf
Apple: Handle generation and comsuption of text-based stubs (.tbd files)
...
Fixes : #24123
2023-03-01 12:23:28 +01:00
scivision
b6cfbe7b17
Help:try_{compile,run}: clarify, encourage new syntax
2023-02-28 08:59:16 -05:00
Brad King
2e469212c8
Dart,FindDart: Add policy to remove these modules
...
These modules and the "DART" tool they support have long been replaced
by CTest.
2023-02-28 08:43:45 -05:00
Brad King
40539096fd
Merge topic 'dll-name-soversion'
...
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
2023-02-28 08:29:20 -05:00
Brad King
22a491c3ea
Merge topic 'ci-linkcheck'
...
c28077ffb3 Help: Replace link with its permanent redirect
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8258
2023-02-28 08:20:52 -05:00
Brad King
4902970328
Merge topic 'doc-cleanup-3.26-rc4'
...
b39b3e3bdb Help: Fix typos and grammar in 3.26 release notes
9f1360ae19 Help: Improve wording of FOLDER-related properties and policies
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8264
2023-02-28 08:07:59 -05:00
Brad King
7b0c4b060b
Merge topic 'doc-cleanup-3.26-rc4' into release-3.26
...
b39b3e3bdb Help: Fix typos and grammar in 3.26 release notes
9f1360ae19 Help: Improve wording of FOLDER-related properties and policies
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8264
2023-02-28 08:07:58 -05:00
Craig Scott
b39b3e3bdb
Help: Fix typos and grammar in 3.26 release notes
2023-02-28 21:24:56 +11:00
Ralf Habacker
a7f9c7da26
Add option to add SOVERSION to DLL names
...
Add variable/target property `[CMAKE_]DLL_NAME_WITH_SOVERSION`.
Fixes : #24251
Signed-off-by: Ralf Habacker <ralf.habacker@freenet.de >
2023-02-27 09:18:34 -05:00
Brad King
c28077ffb3
Help: Replace link with its permanent redirect
2023-02-27 09:09:13 -05:00
Brad King
157e361ff7
Merge topic 'dochttp'
...
9b56aabd99 Help:file: document HTTPHEADER more
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8250
2023-02-27 09:07:06 -05:00
Brad King
9ae0402198
Merge topic 'install-prefix-genex-install-code-script'
...
18e02ace5b install(CODE|SCRIPT): Support $<INSTALL_PREFIX> genex
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Merge-request: !8251
2023-02-27 09:06:20 -05:00
Brad King
03c0a14852
Merge topic 'doc-CMAKE_MODULE_PATH'
...
cf7f6b7165 Help: Document that CMAKE_MODULE_PATH must use forward slashes
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8252
2023-02-27 09:05:25 -05:00
Alexander Neundorf
2ce3d62ffb
Help: add documentation for the new TARGET_RUNTIME_DLL_DIRS genex
2023-02-26 16:36:57 +01:00
Craig Scott
9f1360ae19
Help: Improve wording of FOLDER-related properties and policies
2023-02-25 17:15:17 +11:00
Brad King
cf7f6b7165
Help: Document that CMAKE_MODULE_PATH must use forward slashes
...
Issue: #24240 , #24540
2023-02-24 14:36:29 -05:00
scivision
9b56aabd99
Help:file: document HTTPHEADER more
...
Some servers have allow-lists for HTTP UserAgent for example.
CMake project devs would benefit from this hint about setting
authorization tokens and HTTP User Agent.
2023-02-24 12:32:41 -05:00
Brad King
6e85ad7f8b
Help/dev: Add per-directive sections in CMake Documentation Guide
2023-02-24 12:25:35 -05:00
Kyle Edwards
18e02ace5b
install(CODE|SCRIPT): Support $<INSTALL_PREFIX> genex
...
Fixes : #24534
2023-02-24 10:17:45 -05:00
Brad King
88b75204e5
Merge topic 'PATH-genex-handle-list-of-paths'
...
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
2023-02-24 08:35:19 -05:00
Brad King
1d939b43b2
Merge topic 'tutorial_dependency_inversion'
...
8ddf32196c Tutorial: Refactor MathFunctions code
Acked-by: Kitware Robot <kwrobot@kitware.com >
Tested-by: buildbot <buildbot@kitware.com >
Merge-request: !7789
2023-02-24 08:34:24 -05:00
Markus Ferrell
8ddf32196c
Tutorial: Refactor MathFunctions code
...
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.
2023-02-23 09:42:10 -05:00
Brad King
df9c4b1872
find_package: Use <PACKAGENAME>_ROOT variables as search prefixes
...
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
2023-02-23 09:15:14 -05:00
Brad King
4da27a73bd
Help: Document <PackageName>_ROOT variable ordering using an ordered list
...
Make room to add more steps in a documented order.
2023-02-23 09:12:29 -05:00
Marc Chevrier
e395310a21
PATH-genex: handle lists for path decomposition and transformations
...
Fixes : #24371
2023-02-21 19:34:43 +01:00
Brad King
d25b7ba192
Merge topic 'doco'
...
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
2023-02-21 08:50:07 -05:00
Brad King
ad8ada1bee
Merge topic 'KateNinjaImprovements'
...
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
2023-02-21 08:47:00 -05:00