FeRD (Frank Dana)
bbf3ed5422
Help: Explain block() policy-scope rules more clearly
2023-09-01 21:28:56 +10:00
FeRD (Frank Dana)
2f319c6484
Help: Remove "this command" ambiguity in set() docs
2023-09-01 21:28:56 +10:00
FeRD (Frank Dana)
9eecdc7ab7
Help: Use signature directive for cmake_policy()
2023-09-01 21:28:40 +10:00
Brad King
36a0950e94
Merge topic 'doc-cmake_minimum_required-deprecation'
...
741755f637 Help: Document cmake_minimum_required deprecation of old versions
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: scivision <michael@scivision.dev >
Merge-request: !8742
2023-08-21 09:30:23 -04:00
Brad King
741755f637
Help: Document cmake_minimum_required deprecation of old versions
...
Document the deprecation warnings added by commit 5845c218d7 (Deprecate
compatibility with CMake versions older than 2.8.12, 2020-06-12,
v3.19.0-rc1~629^2) and commit 3a4791548d (Deprecate compatibility with
CMake versions older than 3.5, 2023-02-09, v3.27.0-rc1~508^2).
Fixes : #25196
2023-08-19 09:03:53 -04:00
scivision
136edadad4
Help:try_run: place options in their own section
2023-08-16 10:06:31 -04:00
scivision
a5b292c9a6
Help:try_compile: place options in their own section
...
As try_compile interface was enhanced in 3.25, the Help got a lot
longer. Make the options its own section for navigability.
2023-08-16 10:05:53 -04:00
Kyle Edwards
2ccb897d86
get_test_property(): Add DIRECTORY option
2023-08-11 10:50:52 -04:00
Kyle Edwards
84e76fedb0
get_property(TEST): Add DIRECTORY option
2023-08-11 10:50:52 -04:00
Kyle Edwards
efc8f19cc5
set_tests_properties(): Add DIRECTORY option
2023-08-11 10:50:52 -04:00
Kyle Edwards
753999d4db
set_property(TEST): Add DIRECTORY option
2023-08-10 17:36:14 -04:00
Craig Scott
feca1d51ff
Merge topic 'doc-fixups-release-3.27'
...
78e7ea598d cmLocalGenerator: Fix trivial spelling error in code comment
1285fe27ff Help: Improve formatting and fix wording for ENABLE_EXPORTS
91336d061c Help: Improve formatting and cross-references for DEPENDS_EXPLICIT_ONLY
03208d9e18 Help: Fix indenting within TARGET_RUNTIME_DLLS genex docs
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8688
2023-08-07 18:10:56 -04:00
Brad King
4240e74858
Merge topic 'doc-install'
...
b97350a151 Help: Add more install(TARGETS) examples
0827305032 Help: Clarify install(TARGETS) artifact-kind option group ordering
7bd6478dd0 Help: Use argument value placeholders consistently in install(TARGETS)
ae381e1075 Help: Reorganize install() sections
5d15231a67 Help: Revert "improve install() documentation of argument ordering"
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8683
2023-08-07 12:02:45 -04:00
Brad King
efb21962fb
Merge topic 'cxxmodules-try-compile'
...
be53c75852 cmExperimental: recycle the C++ modules API UUID
deb1c3cbd5 cmCoreTryCompile: forward module-related binutils variables
b768d293c5 cmCoreTryCompile: use the source type context for source files
93993c7ad4 cmArgumentParser: support storing a context value with parsing
c9ca5f6326 cmCoreTryCompile: parse `SOURCES_TYPE` argument
07551f35de cmCoreTryCompile: use `target_sources` for `try_compile` targets
aad9033b56 cmExperimental: support forwarding associated variables to `try_compile`
f6cf433256 cmExperimental: only forward C++ module support to non-ABI checks
...
Acked-by: Kitware Robot <kwrobot@kitware.com >
Tested-by: buildbot <buildbot@kitware.com >
Merge-request: !8639
2023-08-07 11:57:00 -04:00
Craig Scott
91336d061c
Help: Improve formatting and cross-references for DEPENDS_EXPLICIT_ONLY
2023-08-04 19:16:28 +10:00
Brad King
b97350a151
Help: Add more install(TARGETS) examples
...
Add examples showing per-artifact components and per-configuration
destinations.
Fixes : #25144
2023-08-03 12:49:53 -04:00
Brad King
0827305032
Help: Clarify install(TARGETS) artifact-kind option group ordering
...
Revise the signature and description to explicitly distinguish the
initial group of artifact options from later groups that apply to
a specific kind.
Issue: #25144
Fixes : #16362
2023-08-03 12:49:53 -04:00
Brad King
7bd6478dd0
Help: Use argument value placeholders consistently in install(TARGETS)
2023-08-03 12:49:53 -04:00
Brad King
ae381e1075
Help: Reorganize install() sections
...
After switching to the signature directive we no longer need
per-signature sections. Group all the signatures in one section. Add a
table of contents since it is no longer redundant with the synopsis.
2023-08-03 12:49:46 -04:00
Brad King
5d15231a67
Help: Revert "improve install() documentation of argument ordering"
...
Revert commit f09fda97d8 (Help: improve install() documentation of
argument ordering, 2018-01-08, v3.11.0-rc1~126^2). Although the
example it added is correct, its explanation is misleading.
Revert it to make room for an alternative.
Issue: #25144
Issue: #16362
2023-08-03 10:52:11 -04:00
Brad King
da51e8f59b
Help: Cross-reference install command signatures as commands
...
Replace manual anchors with proper command signature cross-references.
2023-08-02 13:43:53 -04:00
Brad King
7a54bdf0c1
Help: Use signature directive for 'install' command
...
Replace manual anchors with signature directives. Indent each
signature's documentation inside its directive.
2023-08-02 13:43:32 -04:00
Ben Boeckel
c9ca5f6326
cmCoreTryCompile: parse SOURCES_TYPE argument
...
This will serve to add context for the source listing in order to
properly mark sources as `FILE_SET TYPE CXX_MODULES` in the generated
code.
2023-07-31 11:37:47 -04:00
Kyle Edwards
4cf5eab79d
Merge topic 'xcframework-find-library'
...
9bf8f7de06 find_library(): Add support for .xcframework
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8661
2023-07-28 14:59:14 -04:00
Kyle Edwards
9bf8f7de06
find_library(): Add support for .xcframework
...
Issue: #21752
2023-07-28 14:41:45 -04:00
Brad King
e49ff2b2f2
Merge topic 'ExportTestLabelToJUnit'
...
2b99e64413 set_test_properties: link to the test properties in the documentation
b11e8afbfa ctest: export test labels to junit xml
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Merge-request: !8635
2023-07-28 09:12:23 -04:00
Kyle Edwards
07ac0c0ae0
Merge topic 'xcframework-target-link-libraries'
...
7050ac56a1 macOS: Add support for linking against .xcframework folders
93ed53790c bootstrap: Unconditionally build libjsoncpp
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8619
2023-07-27 10:06:22 -04:00
Brad King
c46182cf55
Merge topic 'doc-if-exists'
...
3ab132d86f Help: Document that if(EXISTS) requires paths to be readable
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8656
2023-07-27 09:59:20 -04:00
Kyle Edwards
7050ac56a1
macOS: Add support for linking against .xcframework folders
...
Issue: #21752
2023-07-26 17:00:01 -04:00
Alex Neundorf
2b99e64413
set_test_properties: link to the test properties in the documentation
...
It was linking to the target properties, this was probably an oversight.
2023-07-26 22:59:59 +02:00
Brad King
3ab132d86f
Help: Document that if(EXISTS) requires paths to be readable
...
Issue: #25125
2023-07-26 11:06:53 -04:00
Kyle Edwards
ff12a57d5e
exec_program(): Remove by policy CMP0153
2023-07-25 11:09:56 -04:00
Brad King
6194193a8a
Merge topic 'file-REAL_PATH-relative'
...
6b5f2dbbfe file(REAL_PATH): resolve symlinks before '..' components
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Merge-request: !8605
2023-07-24 08:43:19 -04:00
Robert Maynard
6b5f2dbbfe
file(REAL_PATH): resolve symlinks before '..' components
...
Previously REAL_PATH would collapse paths before resolving any symlinks
so if `..` crossed a symlink the output from `REAL_PATH` would be wrong.
It looked like REAL_PATH did this by mistake since it was a side-effect
of ensuring we had an absolute path before resolving symlinks.
2023-07-20 17:02:58 -04:00
Brad King
88c6dc75ba
Merge topic 'command-job-server-aware'
...
95941fd990 add_custom_{target,command}: Add argument JOB_SERVER_AWARE
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Merge-request: !8547
2023-07-20 10:23:31 -04:00
Chris Mahoney
95941fd990
add_custom_{target,command}: Add argument JOB_SERVER_AWARE
...
Issue: #16273
2023-07-19 10:45:33 -04:00
Brad King
18d9a54ba6
Merge topic 'export-doc-config-map'
...
38737e3970 Help: Mention imported config mapping in export() and install() docs
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8637
2023-07-18 13:51:16 -04:00
Brad King
38737e3970
Help: Mention imported config mapping in export() and install() docs
...
Suggest the `CMAKE_MAP_IMPORTED_CONFIG_<CONFIG>` variable for mapping
configurations of dependent projects to configurations exported by these
commands.
Issue: #25096
2023-07-18 11:11:14 -04:00
Brad King
d1538805b5
Merge topic 'doc-add_custom_command'
...
e588d29eaf Help: add_custom_command(TARGET) does not support USES_TERMINAL
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: William Jones <william.luke.jones@gmail.com >
Merge-request: !8602
2023-06-29 11:49:35 -04:00
Brad King
7952e11466
Merge topic 'doc-add_custom_command' into release-3.27
...
e588d29eaf Help: add_custom_command(TARGET) does not support USES_TERMINAL
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: William Jones <william.luke.jones@gmail.com >
Merge-request: !8602
2023-06-29 11:49:34 -04:00
Brad King
e588d29eaf
Help: add_custom_command(TARGET) does not support USES_TERMINAL
...
Build events are attached to existing build statements so we cannot
independently control the job pool.
Issue: #25040
2023-06-29 10:57:38 -04:00
Brad King
6d549cd9fe
Merge topic 'doc-target_precompile_headers'
...
a3dfaf8a5c Help: Fix wrong command name in target_precompile_headers docs
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8600
2023-06-29 10:07:02 -04:00
Brad King
c7e3668b00
Merge topic 'doc-target_precompile_headers' into release-3.27
...
a3dfaf8a5c Help: Fix wrong command name in target_precompile_headers docs
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8600
2023-06-29 10:07:01 -04:00
Brad King
28dc0ef040
Merge topic 'doc-list-xref'
...
60b393096f Help: Link to cmake-language(7) list docs from list() command docs
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8597
2023-06-29 09:54:14 -04:00
Craig Scott
a3dfaf8a5c
Help: Fix wrong command name in target_precompile_headers docs
2023-06-29 09:27:10 +10:00
Brad King
60b393096f
Help: Link to cmake-language(7) list docs from list() command docs
...
Fixes : #25036
2023-06-28 07:51:37 -04:00
Brad King
024791a702
Merge topic 'alias-set-target-prop'
...
aed550410a Help: Clarify that you can't set properties on ALIAS targets
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !8591
2023-06-27 11:03:37 -04:00
Ryan Friedman
aed550410a
Help: Clarify that you can't set properties on ALIAS targets
...
Issue: #19445
Signed-off-by: Ryan Friedman <ryanfriedman5410+github@gmail.com >
2023-06-26 12:47:26 -04:00
Brad King
9189a59f8b
Merge topic 'doc-project-none'
...
9dd2dd5b77 Help: Restore project command docs for default languages and NONE
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: Robert Maynard <robertjmaynard@gmail.com >
Merge-request: !8585
2023-06-23 10:42:25 -04:00
Brad King
5fb68744d4
Merge topic 'doc-project-none' into release-3.27
...
9dd2dd5b77 Help: Restore project command docs for default languages and NONE
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: Robert Maynard <robertjmaynard@gmail.com >
Merge-request: !8585
2023-06-23 10:42:24 -04:00