Commit Graph
9196 Commits
Author SHA1 Message Date
Brad King 4a6a807b00 Merge topic 'tweak-doc' into release-4.3
8b40c3642a Help: Tweak CMAKE_INSTALL_EXPORTS_AS_PACKAGE_INFO

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11727
2026-02-24 14:22:04 -05:00
Matthew Woehlke 8b40c3642a Help: Tweak CMAKE_INSTALL_EXPORTS_AS_PACKAGE_INFO
The format example for CMAKE_INSTALL_EXPORTS_AS_PACKAGE_INFO is quite
long and, in its prior state, was likely to force a line wrap before it,
which could lead to non-optimal spacing of the preceding line. As there
is no easy way to break in the middle of the example, instead break it
out into a separate element.
2026-02-24 12:25:24 -05:00
Brad King d4a3e27d88 Merge topic 'preset-4.3-relnotes' into release-4.3
39ba62fcd5 Help: Update presets release notes for 4.3

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11721
2026-02-24 11:59:57 -05:00
Tyler Yankee 39ba62fcd5 Help: Update presets release notes for 4.3
See commit 23615b7ca4 (presets: Allow jobs to match `ctest -j` with no
value, 2025-12-15) and commit 71ff5a9d6f (presets: Disallow negative
values for "jobs" fields, 2026-01-13) for the changes.

Also update `cmake-presets(7)` itself to correct the behavior change
from the prior commit not respecting the presets file version.
2026-02-23 11:13:28 -05:00
Tyler Yankee 8a74c4c6dc Help: Add 4.3 version tags for string JSON operations
Amend commit 15973ff247 (string(JSON): Add GET_RAW mode, 2025-12-16)
and commit 06e6f1e69f (string(JSON): Add STRING_ENCODE mode,
2025-12-16).

Fixes: #27633
2026-02-22 17:00:30 -05:00
Matthew Woehlke e71ec689cf Help: Update CPS release notes for 4.3
Add a dedicated section for CPS support. Remove note about changes to
CPS export, since the no-longer-experimental support is treated as a new
feature.
2026-02-19 17:05:50 -05:00
Ben Boeckel 0cd5cf81b4 Help/cmake-cxxmodules: clarify stdlib support for Clang by name
Rather than by flag which might imply that an explicit flag is
necessary.
2026-02-18 16:04:43 -05:00
Ben Boeckel 306e927243 Help/cmake-cxxmodules: note Ubuntu 26.04 requirement for GCC import std 2026-02-18 16:03:36 -05:00
Ben Boeckel bdbbc98651 Help/cmake-cxxmodules: drop "preview" release of Visual Studio
The final release is out; no need to mention prerelease versions.
2026-02-18 15:53:50 -05:00
Brad King 49fb4a3695 Help: Drop development topic notes to prepare release
Release versions do not have the development topic section of
the CMake Release Notes index page.
2026-02-17 14:20:31 -05:00
Brad King 62d573134e Help: Organize and revise 4.3 release notes
Add section headers similar to the 4.2 release notes and move each
individual bullet into an appropriate section.  Revise a few bullets.
2026-02-17 13:32:57 -05:00
Brad King 0454ef4764 Help: Consolidate 4.3 release notes
Run the `Utilities/Release/consolidate-relnotes.bash` script to move
notes from `Help/release/dev/*` into `Help/release/4.3.rst`.
2026-02-17 13:31:16 -05:00
Brad King 1202254cd5 Merge topic 'improve-doc-consistency'
277c12a4c7 Help: Improve command usage formatting consistency

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11687
2026-02-16 08:43:11 -05:00
Brad King a4373ca252 Merge topic 'cpack-wix-perUser'
781754f505 CPack/WiX: Add support for perUser install scope

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11680
2026-02-14 16:27:14 -05:00
Matthew Woehlke 277c12a4c7 Help: Improve command usage formatting consistency
Try to be a bit more consistent about:

- Placing angle brackets around text which serves as a placeholder
  rather than being literal.

- Using curly brackets rather than angle brackets to denote groups where
  one of the options is required.

- Describing optional list arguments like `<x>...` rather than
  `[<x>...]`. (Instances of lists not associated with keywords are
  intentionally left as-is, however.)

Also, teach our CMake lexer to understand curly braces used as above
(prior uses were only in parsed literals without syntax highlighting),
and to highlight them (and remaining uses of angle braces) as the type
Punctuation rather than the type Operator, for consistency with square
braces.
2026-02-13 12:54:37 -05:00
Ivan Desiatov 781754f505 CPack/WiX: Add support for perUser install scope
This allows one to create installers that install to `AppDataLocal`
and do not require admin privileges to execute.

Fixes: #24939
2026-02-13 10:57:39 -05:00
Brad King 3990abf9fb Merge topic 'doc-cmake_path-out-var'
6592b8ac14 Help/cmake_path: Clarify output variable behavior

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11681
2026-02-13 09:57:04 -05:00
Brad King eec5d93813 Merge topic 'update_sbom_docs_gen_exp'
54ac3937b6 Help: Warn about generator expressions in install(SBOM) docs

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11685
2026-02-13 09:52:39 -05:00
Brad King 84aff9588f Merge topic 'remove-cps-experimental-gate'
f5c515cbf2 CPS: Remove experimental gate (mostly)

Acked-by: Kitware Robot <kwrobot@kitware.com>
Tested-by: buildbot <buildbot@kitware.com>
Merge-request: !11683
2026-02-13 09:51:24 -05:00
Tyler Yankee 6592b8ac14 Help/cmake_path: Clarify output variable behavior
Add explicit cross-references for commands which optionally take an
output variable (otherwise modifying their input in-place) for clarity.

Note that `cmake_path` should not be used to modify variables reserved
by CMake.

Improve references to the "CMake-style" semicolon-separated lists, and
apply those corresponding changes to the `file` command page.
2026-02-12 12:50:51 -05:00
Tom Osika 54ac3937b6 Help: Warn about generator expressions in install(SBOM) docs 2026-02-12 12:07:47 -05:00
Brad King cf90886f8b Merge topic 'help-cxxmodules-import-std-no-vs'
f038117687 Help/cmake-cxxmodules: note that VS generators do not support `import std`

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11682
2026-02-12 11:08:02 -05:00
Matthew Woehlke f5c515cbf2 CPS: Remove experimental gate (mostly)
Remove basic CPS import and export from 'experimental' status. Update
documentation and tests accordingly.

Note that mapped exports (CMAKE_EXPERIMENTAL_MAPPED_PACKAGE_INFO) are
still experimental.
2026-02-11 16:10:29 -05:00
Brad King 9d2fc99a95 Merge topic 'cmake-locale-query'
b02ae60a76 cmake_host_system_information: Add query for the locale's charset

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11648
2026-02-11 12:41:12 -05:00
Ben Boeckel f038117687 Help/cmake-cxxmodules: note that VS generators do not support import std
Closes: #27595
2026-02-11 12:13:17 -05:00
Brad King 0aa7e258d4 Merge topic 'doc-ctest-link'
01a47a790b Help: Link `CTEST_*` variables to dashboard client
12a0ebe96a Help/CTest: Improve formatting and grammar

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11677
2026-02-11 12:05:29 -05:00
Brad King b02ae60a76 cmake_host_system_information: Add query for the locale's charset
Issue: #27562
2026-02-11 11:56:05 -05:00
Tyler Yankee 01a47a790b Help: Link CTEST_* variables to dashboard client 2026-02-10 09:59:45 -05:00
Brad King e686b86649 Merge topic 'import-std-no-experimental'
70c1f0f43d Experimental: Remove import std experimental gate

Acked-by: Kitware Robot <kwrobot@kitware.com>
Tested-by: buildbot <buildbot@kitware.com>
Merge-request: !11657
2026-02-08 09:18:01 -05:00
Brad King a59a6c2ca0 Merge topic 'rust-support'
5c1b0a6b7e Rust: Add experimental support with Ninja
3fe1e45584 ci: Add rustc to Fedora base image

Acked-by: Kitware Robot <kwrobot@kitware.com>
Acked-by: Michał Walenciak <michalwalenciak@gmail.com>
Merge-request: !11389
2026-02-07 09:30:19 -05:00
Brad King 39a0fb289d Merge topic 'doc/install-remove-superfluous-dots'
231b336ad2 Help: Fix typo in `install` documentation
01ea8dc368 Help: Correct use of dots ([...]) in `install` command signatures

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11659
2026-02-07 09:28:42 -05:00
Brad King 7f01b3fe89 Merge topic 'doc-sf-prop-labels-xref'
39c6406dfe Help/prop_sf/LABELS: link to the `LABELS` target property

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11665
2026-02-07 09:25:39 -05:00
Vito Gamberini 70c1f0f43d Experimental: Remove import std experimental gate
Fixes: #27571
2026-02-07 09:03:43 -05:00
Ayush Singh 5c1b0a6b7e Rust: Add experimental support with Ninja
The TU for Rust is a crate, not per-source.  `rustc` expects entry file
to TU as input, and cannot work with object files.  So we need to have
one-step build/link in most cases, similar to what old Swift was doing.

Issue: #25492
Signed-off-by: Ayush Singh <ayush@beagleboard.org>
2026-02-06 11:32:56 -05:00
Brad King d979f3df74 Merge topic 'fileapi-interface-sources'
b8af7837b3 fileapi: Add interfaceSources to the target codemodel replies

Acked-by: Kitware Robot <kwrobot@kitware.com>
Tested-by: buildbot <buildbot@kitware.com>
Merge-request: !11655
2026-02-06 10:37:20 -05:00
Ben Boeckel 39c6406dfe Help/prop_sf/LABELS: link to the LABELS target property 2026-02-06 09:09:00 -05:00
Martin Duffy 95dc40d8a8 Experimental: Remove Instrumentation experimental gating
Fixes: #27348
2026-02-05 14:05:42 -05:00
Brad King 713c36bc0e Merge topic 'instrumentation-project-name'
ffff6576b4 instrumentation: Add project field to cmake content files

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11650
2026-02-05 13:50:56 -05:00
Brad King 8af7c1c0c3 Merge topic 'patch-enable-testing'
4cde2dd45b enable_testing: Update docs

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11656
2026-02-05 13:21:28 -05:00
Brad King 37614c8f79 Merge topic 'cmd-version-json'
39a3915022 cmd: implement json version output
89fd18b48e nghttp2: provide common cm3p headers
31bb76eafd Utilities: add lost openssl dependency
26cdd956ac kwiml: provide common cm3p version header
4952dc9d4a Merge branch 'upstream-KWIML' into cmd-version-json
b41743ddcb KWIML 2025-08-05 (2eae04db)
25c05b0bac kwiml: Update script to get version header

Acked-by: Kitware Robot <kwrobot@kitware.com>
Tested-by: buildbot <buildbot@kitware.com>
Merge-request: !11630
2026-02-05 13:11:08 -05:00
Craig Scott b8af7837b3 fileapi: Add interfaceSources to the target codemodel replies
Fixes: #27489
2026-02-05 21:20:48 +09:00
Christoph Grüninger 231b336ad2 Help: Fix typo in install documentation 2026-02-05 08:02:05 +01:00
Christoph Grüninger 01ea8dc368 Help: Correct use of dots ([...]) in install command signatures
Only the short form of command have the [...] at
the end to indicate further possible arguments.
Repeating of a block is indicated by ..., not [...].
2026-02-05 07:57:32 +01:00
Peter Kokot 4cde2dd45b enable_testing: Update docs
- Described where this command shouldn't be called.
- Added examples section.
- Reworded few sentences.

Issue: #27564
2026-02-04 17:32:54 +01:00
Brad King 9e5d338dd9 Merge topic 'lang-link-flags'
98f9874703 cmake: Add per-language link flags for all target types
63858fc3e0 Tests: Factor out LINKER: reference file generation
399288871e cmLocalGenerator: Factor out link flag parsing
82913923cd try_compile: Reflow comments per `clang-format`
7b4b556e2d Help: Fix description of `CMAKE_*_LINKER_FLAGS` variables
29b1d0baa9 Help/try_compile: Remove extraneous `versionadded` policy note
5ecee0db7b cmLocalGenerator: De-duplicate static linker flags lookup
bc1847c70b cmLocalGenerator: De-duplicate target property link flags lookup
...

Acked-by: Kitware Robot <kwrobot@kitware.com>
Tested-by: buildbot <buildbot@kitware.com>
Merge-request: !11611
2026-02-03 11:22:36 -05:00
Brad King 46c3f6c2b0 Merge topic 'doc-exports-def'
3400248c1a Help: Add documentation for `<target>_EXPORTS` compile definition

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11644
2026-02-03 10:40:22 -05:00
Brad King 98f32902a5 Merge topic 'doc-marco-arguments'
69456b012a Help: Clarify argument handling for macros

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11641
2026-02-03 10:39:20 -05:00
Martin Duffy ffff6576b4 instrumentation: Add project field to cmake content files 2026-02-03 09:15:49 -05:00
AJIOB 39a3915022 cmd: implement json version output 2026-02-03 09:34:23 +03:00
Ralf Habacker 3400248c1a Help: Add documentation for <target>_EXPORTS compile definition
Fixes: #27554
2026-02-02 11:07:01 -05:00