Brad King
7095118a78
Merge topic 'fix-copy-on-error-directory-info' into release-4.2
...
657e9be724 file(CREATE_LINK): Document `COPY_ON_ERROR` behavior on directories
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11299
2025-10-12 09:20:18 -04:00
Alex Overchenko
657e9be724
file(CREATE_LINK): Document COPY_ON_ERROR behavior on directories
...
Issue: #27294
2025-10-10 10:26:36 -04:00
Brad King
3f87b4d5d8
Merge topic 'doc-cmake_path' into release-4.2
...
c575d84555 Help: Use signature directive for `cmake_path` command
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11294
2025-10-10 10:24:24 -04:00
Brad King
32d776ea0b
Merge topic 'doc-ctest-env-whitespace' into release-4.2
...
597e421ba3 Help: Remove incorrect Windows env var limitation from CTEST_PARALLEL_LEVEL
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11297
2025-10-10 10:21:44 -04:00
Brad King
706bf669e1
Merge topic 'doc-apple-arch-default' into release-4.2
...
6055a12d36 Help: Document default architecture when CMAKE_OSX_ARCHITECTURES is not set
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: rumgot rumgotov <rumgot@gmail.com >
Merge-request: !11296
2025-10-10 10:19:10 -04:00
Brad King
79bc6f6b60
Help: Drop development topic notes to prepare release
...
Release versions do not have the development topic section of
the CMake Release Notes index page.
2025-10-09 10:20:36 -04:00
Brad King
597e421ba3
Help: Remove incorrect Windows env var limitation from CTEST_PARALLEL_LEVEL
...
In commit 5de1e21659 (ctest: Allow passing -j without value to choose a
contextual default, 2024-03-06, v3.29.0-rc4~10^2) I misdiagnosed the
reason that the test could not set an empty environment variable on
Windows. It is actually a limitation of `set(ENV{VAR})` inherited from
its implementation using `_wputenv`. Process environment blocks can
contain empty environment variables.
Issue: #27285
2025-10-09 09:46:01 -04:00
Brad King
5e9722866a
Help: Update Sphinx versionadded directives for 4.2 release
...
Run the script:
Utilities/Sphinx/update_versions.py --since v4.1.0 --overwrite
2025-10-09 09:38:20 -04:00
Brad King
5c7e90d954
Help: Organize and revise 4.2 release notes
...
Add section headers similar to the 4.1 release notes and move each
individual bullet into an appropriate section. Revise a few bullets.
2025-10-09 09:38:02 -04:00
Brad King
ec28123cb4
Help: Consolidate 4.2 release notes
...
Run the `Utilities/Release/consolidate-relnotes.bash` script to move
notes from `Help/release/dev/*` into `Help/release/4.2.rst`.
2025-10-09 09:36:44 -04:00
Brad King
6055a12d36
Help: Document default architecture when CMAKE_OSX_ARCHITECTURES is not set
...
Issue: #27293
2025-10-09 09:31:49 -04:00
Martin Duffy
f195c9ef2a
genex: Add TARGET_INTERMEDIATE_DIR expression
...
Fixes : #27196
2025-10-09 08:07:20 -04:00
Tyler Yankee
c575d84555
Help: Use signature directive for cmake_path command
...
Using `signature` renders the anchor links for each sub-command, and is
consistent with the other `Help/command` pages which contain multiple
sub-commands.
2025-10-08 20:44:38 -04:00
Craig Scott
f38f325e08
fileAPI: Add direct dependencies to target codemodel files
...
This adds the following new arrays, which together capture all direct
dependencies and interface dependencies of a target:
- linkLibraries
- interfaceLinkLibraries
- compileDependencies
- interfaceCompileDependencies
- objectDependencies
- orderDependencies
Fixes : #21995 , #25213
2025-10-07 10:44:28 -04:00
Brad King
0181fb4cc5
Merge topic 'define-msvc-charset'
...
b554dead95 Tests: Cover CMP0203 and CMP0204 on all platforms
6874efb592 MSVC: Always define a character set
2cae68ecbe Source: Minor optimizations
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11269
2025-10-07 10:43:08 -04:00
AJIOB
6874efb592
MSVC: Always define a character set
...
When targeting the MSVC ABI, define `_MBCS` by default if the project
does not define `_SBCS` or `_UNICODE`. Visual Studio has long defined
one of the three character set macros automatically. For consistency,
define it when compiling for the MSVC ABI with other generators.
Add policy CMP0204 for compatibility.
Fixes : #27275
2025-10-07 09:29:32 -04:00
Brad King
927ccf212f
Merge topic 'help-TRYRUN_OUTPUT_STDOUT'
...
6d61783103 Help: Document try_run output cache entries for cross-build
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11284
2025-10-07 09:02:32 -04:00
Brad King
9126ed5162
Merge topic 'fix_dev_docs_typo'
...
2b5fcf1d07 Help/dev: Fix typo in Source Code Guide
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11282
2025-10-06 10:40:08 -04:00
Jinzhe Zeng
6d61783103
Help: Document try_run output cache entries for cross-build
...
Document `try_run` cache entries added by commit a2cd0687db (try_run:
Add RUN_OUTPUT_STDOUT_VARIABLE and RUN_OUTPUT_STDERR_VARIABLE.,
2022-07-08, v3.25.0-rc1~443^2):
* `<runResultVar>__TRYRUN_OUTPUT_STDOUT`
* `<runResultVar>__TRYRUN_OUTPUT_STDERR`
Fixes : #27281
2025-10-06 10:33:54 -04:00
Alex Overchenko
2b5fcf1d07
Help/dev: Fix typo in Source Code Guide
2025-10-06 10:20:03 -04:00
Vito Gamberini
c8adfdb0a8
Tutorial: Fix typos and mislabeled code blocks
2025-10-03 18:01:06 -04:00
Brad King
0d01bc72b8
Merge topic 'cps-symbolic-info'
...
62a1d3e7f1 FileAPI: Add symbolic property to targets
d92b6c3e20 CPS: Add Symbolic Components
03284e018f Help: Simplify file-api version information for "abstract" field
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Merge-request: !11132
2025-10-03 11:24:50 -04:00
Brad King
caf01b88bc
Merge topic 'instrumentation-target-content'
...
97adbc91fa instrumentation: Move target data into content files
Acked-by: Kitware Robot <kwrobot@kitware.com >
Tested-by: buildbot <buildbot@kitware.com >
Merge-request: !11251
2025-10-03 11:21:17 -04:00
Brad King
75c9a28459
Merge topic 'tutorial-fileset-fix'
...
07518509db Tutorial: Fix example FILE_SET names
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11279
2025-10-03 11:18:39 -04:00
Vito Gamberini
07518509db
Tutorial: Fix example FILE_SET names
...
FILE_SET names begin with lowercase letters, the examples use uppercase
Fixes #27282
2025-10-02 19:00:43 -04:00
Brad King
490b6fe1f2
Merge topic 'build-graph-opt-docs'
...
fac5e622b7 Help/OPTIMIZE_DEPENDENCIES: xref with CMP0154 documentation
03f5ffa2ca Help/OPTIMIZE_DEPENDENCIES: move period outside of parenthetical
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11275
2025-10-02 13:56:27 -04:00
Brad King
0599d7e606
Merge topic 'doc-polish'
...
6babe38916 Help: Fix cmake_language(TRACE) command anchor
7aa81ae324 Help: Simplify release notes for find module version variables
09aded59f7 Help: Revise CMP0201 documentation using typical wording conventions
f98b4eecf6 Help: Document generators supporting CMAKE_INTERMEDIATE_DIR_STRATEGY
fe9fd66a8e Help: Improve CPack/WiX documentation markup
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11276
2025-10-02 13:52:22 -04:00
Brad King
731ba7cf39
Merge topic 'doc-interface-libraries'
...
e3a1a688ea Help: Clarify property names allowed on interface libraries
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11274
2025-10-02 13:50:32 -04:00
Taylor Sasser
62a1d3e7f1
FileAPI: Add symbolic property to targets
2025-10-02 10:46:16 -04:00
Taylor Sasser
d92b6c3e20
CPS: Add Symbolic Components
...
Adds support for "symbolic" components, which represent feature-level
capabilities of a package that do not correspond to actual build targets.
These are modeled as pseudo-targets, using the INTERFACE type as a base,
and can be queried via:
get_target_property(... <tgt> "SYMBOLIC")
This enables consumers to declare requirements on optional features
(e.g., SSL support) even when they do not map to concrete targets.
Fixes : #27187
2025-10-02 10:46:02 -04:00
Martin Duffy
97adbc91fa
instrumentation: Move target data into content files
...
Create a single place to store target data to prevent duplication.
This moves `targetType` and `targetLabels` out of the snippet files
and into a target map in the `cmakeContent` file referenced by each
snippet.
Fixes : #27244
2025-10-02 09:28:20 -04:00
Brad King
03284e018f
Help: Simplify file-api version information for "abstract" field
2025-10-01 09:35:47 -04:00
Brad King
6babe38916
Help: Fix cmake_language(TRACE) command anchor
2025-10-01 09:23:33 -04:00
Brad King
7aa81ae324
Help: Simplify release notes for find module version variables
...
Avoid repeating almost identical information for every module.
Document the pattern of the change and refer the reader to individual
modules for details.
2025-10-01 09:23:33 -04:00
Brad King
09aded59f7
Help: Revise CMP0201 documentation using typical wording conventions
2025-10-01 09:23:32 -04:00
Brad King
f98b4eecf6
Help: Document generators supporting CMAKE_INTERMEDIATE_DIR_STRATEGY
...
Move this information from the release note to the actual docs.
2025-10-01 09:23:32 -04:00
Brad King
fe9fd66a8e
Help: Improve CPack/WiX documentation markup
2025-10-01 09:23:32 -04:00
Brad King
bef873755b
Merge topic 'define-windll'
...
83bbde5449 MSVC: Define _WINDLL consistently for shared libraries
206fcbb392 Tests/RunCMake/FileAPI: Fix whitespace in codemodel-v2 expectation data
Acked-by: Kitware Robot <kwrobot@kitware.com >
Tested-by: buildbot <buildbot@kitware.com >
Merge-request: !11194
2025-10-01 09:18:05 -04:00
Ben Boeckel
fac5e622b7
Help/OPTIMIZE_DEPENDENCIES: xref with CMP0154 documentation
...
Closes : #27250
2025-09-30 22:59:04 -04:00
Ben Boeckel
03f5ffa2ca
Help/OPTIMIZE_DEPENDENCIES: move period outside of parenthetical
...
The preceding sentence needs a terminator.
2025-09-30 22:58:34 -04:00
Brad King
e3a1a688ea
Help: Clarify property names allowed on interface libraries
...
Replace the explicit list of common `INTERFACE_*` property names
with links to the dedicated sections listing usage requirements.
Restore documentation of the pre-3.19 restrictions on property names,
previously removed by commit afb998704e (Remove filtering of allowed
INTERFACE library properties, 2020-07-14, v3.19.0-rc1~346^2~2).
Issue: #27271
2025-09-30 20:18:47 -04:00
Brad King
ec0cf06316
Merge topic 'instrumentation-always-record-build'
...
e730008d7e instrumentation: Record build snippets regardless of hooks
Acked-by: Kitware Robot <kwrobot@kitware.com >
Tested-by: buildbot <buildbot@kitware.com >
Merge-request: !11255
2025-09-30 10:05:02 -04:00
AJIOB
83bbde5449
MSVC: Define _WINDLL consistently for shared libraries
...
Visual Studio defines this automatically for `.dll` targets.
For consistency, define it when compiling for the MSVC ABI
with other generators. Add policy CMP0203 for compatibility.
Fixes : #27253
2025-09-29 18:26:44 -04:00
Brad King
093cb74cd1
Merge topic 'tutorial-markup'
...
fcc2800f64 Tutorial: text not correctly rendered
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11256
2025-09-29 09:26:01 -04:00
Brad King
5291c17310
Merge topic 'instrumentation-load-null'
...
11f67d416a instrumentation: Use null when CPU load is unknown
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11248
2025-09-29 09:23:03 -04:00
Brad King
e49de5d5d6
Merge topic 'fileapi-interface-and-imported-targets'
...
b626843d71 fileAPI: Output all INTERFACE and IMPORTED targets
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11232
2025-09-29 09:21:45 -04:00
Martin Duffy
e730008d7e
instrumentation: Record build snippets regardless of hooks
2025-09-26 15:55:08 -04:00
Adrien Ollier
fcc2800f64
Tutorial: text not correctly rendered
...
There are some restrictions on backquotes markup.
One of them is it must be separated from
surrounding text by non-word characters.
2025-09-26 17:42:59 +02:00
Tyler Yankee
11f67d416a
instrumentation: Use null when CPU load is unknown
2025-09-26 10:16:32 -04:00
Brad King
441b1ebe75
Merge topic 'patch-found-variables'
...
0fedf1592c Find*: Update *_FOUND variables
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !11220
2025-09-26 09:58:27 -04:00