Ben Boeckel
0e9782b336
msvc: bless MSVC 19.34 support for C++ modules as experimental
...
Visual Studio 17.4 now contains official support for what CMake needs.
2022-11-11 16:54:05 -05:00
Brad King
c30cd5fef1
Merge topic 'sphinx-linkcheck' into release-3.25
...
435b0c573c Help: Fix some redirects reported with sphinx linkcheck
ac5295a9de Help: Fix broken external links found by sphinx linkcheck
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !7876
2022-11-08 09:02:30 -05:00
Brad King
09fb50a167
Merge topic 'doc-block-return' into release-3.25
...
1046a61cfd Help: clean up and clarify block() and return()
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !7872
2022-11-08 09:01:23 -05:00
Brad King
db24442007
Merge topic 'doc-msvc-abi' into release-3.25
...
128c414a56 Help: Clarify compilers affected by MSVC ABI abstractions
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !7881
2022-11-08 08:16:43 -05:00
Brad King
f3a4c73c68
Merge topic 'tasking_update_toolset_doc' into release-3.25
...
beade1cb42 Tasking: Update CMAKE_TASKING_TOOLSET documentation
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !7880
2022-11-08 08:13:22 -05:00
Brad King
128c414a56
Help: Clarify compilers affected by MSVC ABI abstractions
...
The `MSVC_DEBUG_INFORMATION_FORMAT` and `MSVC_RUNTIME_LIBRARY`
abstractions apply to any compilers targeting the MSVC ABI.
Fixes : #24137
2022-11-07 10:47:15 -05:00
Alex Turbov
435b0c573c
Help: Fix some redirects reported with sphinx linkcheck
...
Mostly it's about replace `http:` with `https:` protocol.
2022-11-07 10:07:36 -05:00
Alex Turbov
ac5295a9de
Help: Fix broken external links found by sphinx linkcheck
2022-11-07 10:05:41 -05:00
Christoph Seitz
beade1cb42
Tasking: Update CMAKE_TASKING_TOOLSET documentation
...
Clarify the relationship between the compiler version and
toolset/architecture.
Fixes : #24117
2022-11-07 09:24:03 -05:00
Craig Scott
1046a61cfd
Help: clean up and clarify block() and return()
2022-11-08 00:05:55 +11:00
Craig Scott
7e1a4567fb
Help: Make VALIDATOR wording clearer and more precise
2022-11-07 23:51:51 +11:00
Brad King
1527534548
Merge branch 'release-3.24' into release-3.25
2022-11-01 12:58:26 -04:00
Brad King
c974557598
CMake 3.24.3
2022-11-01 10:55:49 -04:00
Brad King
2c5760ac2c
Merge branch 'release-3.24' into release-3.25
2022-11-01 10:40:42 -04:00
Brad King
d697bbd03d
Merge branch 'release-3.23' into release-3.24
2022-11-01 10:40:34 -04:00
Brad King
91ccfa3302
CMake 3.23.5
2022-11-01 09:36:33 -04:00
Craig Scott
3fc2dcd801
Help: Minor formatting and cross-ref cleanup for <CONFIG>_POSTFIX
2022-10-28 09:26:28 +11:00
Brad King
33d610a076
Merge topic 'cmake-presets-workflow-arguments' into release-3.25
...
7ecbe324b0 cmake --workflow: add --fresh option
7d9aa0f00c cmake::Workflow: Refactor to use enum class argument
322193afcd cmake --workflow: print usage and exit on unrecognized argument
70aef29427 cmake --workflow: print usage message
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Merge-request: !7825
2022-10-27 09:43:38 -04:00
Kyle Edwards
7ecbe324b0
cmake --workflow: add --fresh option
...
Fixes : #24073
2022-10-26 12:01:25 -04:00
Markus Ferrell
277fbb3035
Tutorial: Restore USE_MYMATH in place of MY_MATH
...
In commit 80f5d28813 (Tutorial: Update step 2 style, 2022-07-25,
v3.25.0-rc1~226^2) we replaced some uses of `USE_MYMATH` with `MY_MATH`.
Restore the former name for consistency with the rest of the tutorial.
2022-10-25 16:31:38 -04:00
Brad King
19f49a7514
Merge topic 'doc-presets' into release-3.25
...
8a413eb8d0 Help: State default preset strategy for architecture and toolset
8de977fa70 Help: Use array consistently in presets manual
e11773e8cf Help: Fix trivial typos related to presets
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !7817
2022-10-25 10:37:23 -04:00
Craig Scott
8a413eb8d0
Help: State default preset strategy for architecture and toolset
2022-10-22 16:21:34 +11:00
Craig Scott
8de977fa70
Help: Use array consistently in presets manual
...
When referring to data in a JSON array, use "array" consistently
rather than "list". This avoids ambiguity over whether we mean
a string containing a CMake list, or a JSON array.
Fixes : #24074
2022-10-22 16:19:19 +11:00
Craig Scott
e11773e8cf
Help: Fix trivial typos related to presets
2022-10-22 16:17:13 +11:00
Michael Hirsch
36d76ed07c
Help: cmake(1), ctest(1), versionadded for key flags
2022-10-21 10:55:15 -04:00
Brad King
63d28469cd
Merge topic 'doc-cli-xrefs' into release-3.25
...
3043c17039 Help: Add more CLI `:option:` references to various pages
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !7811
2022-10-21 10:19:53 -04:00
Alex Turbov
3043c17039
Help: Add more CLI :option: references to various pages
2022-10-20 11:21:40 -04:00
Alex Turbov
65dc8aa8b3
Help: Mention CMake version for a recently-added find_package search path
...
Add a `versionadded` mark for the search path added by commit e55c154c5b
(cmFindPackageCommand: Add one more search path, 2022-06-27,
v3.25.0-rc1~339^2~1).
Fixes : #24067
2022-10-20 11:17:46 -04:00
Alex Turbov
93871cb5a9
Help: Reformat find_package search paths as Sphinx tables
2022-10-20 11:17:46 -04:00
Brad King
6fa189f716
Merge topic 'cmake-presets-output-junit' into release-3.25
...
bea4ed5430 CTest: Add support for outputJUnitFile in presets
9270a02003 CMakePresets.json: Add outputJUnitFile to test presets schema
757786bb73 Tests: Add test for outputLogFile in CMakePresets.json
b68c3596e7 CMakePresets.json: Disallow extra properties in test output schema
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: scivision <michael@scivision.dev >
Merge-request: !7806
2022-10-19 10:04:29 -04:00
Kyle Edwards
bea4ed5430
CTest: Add support for outputJUnitFile in presets
...
Fixes : #22400
2022-10-18 16:52:23 -04:00
Brad King
20587e5af9
Merge topic 'doc-flag-init' into release-3.25
...
e0075799ed Help: Clarify how language-specific flag environment values are used
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !7804
2022-10-18 15:32:26 -04:00
Kyle Edwards
b68c3596e7
CMakePresets.json: Disallow extra properties in test output schema
...
And add test for testOutputTruncation being unsupported.
2022-10-18 14:40:11 -04:00
Brad King
e0075799ed
Help: Clarify how language-specific flag environment values are used
...
Previous the wording could be interpreted to mean that the environment
variables like `CXXFLAGS` are used exclusively to initialize the
corresponding cache entries like `CMAKE_CXX_FLAGS`. State clearly
that the value will be used in combination with builtin defaults.
Issue: #23956
2022-10-18 14:10:41 -04:00
Brad King
65542be970
Merge topic 'doc-CMAKE_ANDROID_API' into release-3.25
...
a739b55bb6 Help: Clarify historical-only role of CMAKE_ANDROID_API variable
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !7800
2022-10-18 13:49:52 -04:00
Brad King
a739b55bb6
Help: Clarify historical-only role of CMAKE_ANDROID_API variable
...
Revise documentation added by commit 6b84df8da9 (Help: Document cross
compiling for Android, 2016-06-20, v3.7.0-rc1~229^2~2) to avoid implying
that `CMAKE_ANDROID_API` is interchangeable with `CMAKE_SYSTEM_VERSION`.
The latter is the authoritative value of the Android API level.
Issue: #23830
2022-10-17 11:42:46 -04:00
Steven
5b7e465be3
Tutorial: Fix variable name typo in step 1
...
`CMAKE_CXX_REQUIRED_STANDARD` => `CMAKE_CXX_STANDARD_REQUIRED`
2022-10-17 10:36:15 -04:00
Brad King
4cb8564087
Merge topic 'doc-timestamp-f' into release-3.25
...
7d25ae7350 Help: Add versionadded for string(TIMESTAMP) %f specifier
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !7796
2022-10-17 10:00:57 -04:00
Brad King
7780588d82
Merge branch 'doc-timestamp-f' into release-3.24
...
Merge-request: !7796
2022-10-14 11:33:14 -04:00
Brad King
7d25ae7350
Help: Add versionadded for string(TIMESTAMP) %f specifier
...
This was accidentally left out of commit c050d6a01e (string(TIMESTAMP):
add %f specifier for microseconds, 2022-01-27, v3.23.0-rc1~59^2).
2022-10-14 11:28:38 -04:00
Brad King
f9fd27a5ee
Help: Fix typo that crashes older pygments lexers
...
In commit cb14ae2b87 (try_compile: Add SOURCE_FROM_{ARG,VAR},
2022-09-21, v3.25.0-rc1~94^2~2) we accidentally added unbalanced closing
`]` characters in the `try_compile` and `try_run` signatures.
Fixes : #24053
2022-10-13 12:04:00 -04:00
Brad King
8cfd8a6486
Merge topic 'doc-gen' into release-3.25
...
9e8b8bf4ef Help: Document version when COMPILE_LANGUAGE genex accepts multiple languages
16f37ea7a0 Help: Document comma-separation in some generator expressions
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !7784
2022-10-12 10:21:02 -04:00
Michael Hirsch
9e8b8bf4ef
Help: Document version when COMPILE_LANGUAGE genex accepts multiple languages
2022-10-12 09:42:36 -04:00
Michael Hirsch
16f37ea7a0
Help: Document comma-separation in some generator expressions
2022-10-12 09:42:19 -04:00
Alex Turbov
26020fdaae
Help: Reference options of sub-commands in some older release notes (>= 3.20)
2022-10-12 09:29:48 -04:00
Alex Turbov
c3ec1b7411
Help: Replace the ref cmake --workflow --preset with option role
...
So, it'll look the same as refs to other commands in this release
notes below.
2022-10-12 09:29:48 -04:00
Alex Turbov
a0349eb13f
Help: Make cmake(1) sub-command options look like other options
...
Particularly,
- options for `cmake -E env`
- options for `cmake -E tar`
2022-10-12 09:29:48 -04:00
Brad King
e4a53a50eb
Help: Drop development topic notes to prepare release
...
Release versions do not have the development topic section of
the CMake Release Notes index page.
2022-10-11 11:12:07 -04:00
Brad King
cfd149387e
Merge topic 'doc-3.25-relnotes'
...
286a40cb5b Help: Update Sphinx versionadded directives for 3.25 release
f93f97d6c2 Help: Organize and revise 3.25 release notes
c174ef23f4 Help: Consolidate 3.25 release notes
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !7751
2022-10-11 11:10:56 -04:00
Brad King
f5e8251497
Merge topic 'doc-misc-trivial-cleanups'
...
321eb0c33d Help: Tasking compiler supports compile warning as error
f8b3b24915 Help: Minor grammar, typo and formatting cleanups
3de30134f1 Help: Re-sort property, variable and compiler id lists
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !7769
2022-10-11 10:12:04 -04:00