Matthew Woehlke
dd8bf95271
Help: Document handling of CPS transitive components
...
Add documentation explaining how CMake handles component requests of a
CPS transitive dependency.
2025-03-07 13:19:43 -05:00
Brad King
455f2249bc
Merge topic 'fix-cps-component-documentation' into release-4.0
...
76e11bd4ea Help: Fix find_package documentation about CPS and COMPONENTS
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Merge-request: !10405
2025-03-04 08:45:06 -05:00
Kitware Robot
de273b2e11
LICENSE: Replace references to Copyright.txt with LICENSE.rst
...
```
git grep -lz 'Copyright.txt or https://cmake.org/licensing ' |
while IFS= read -r -d $'\0' f ; do
sed -i '/Copyright.txt or https:\/\/cmake.org\/licensing / {
s/Copyright.txt/LICENSE.rst/
}' "$f" ; done
```
2025-03-03 09:56:07 -05:00
Marc Chevrier
b0d0a8d54f
Help: CMAKE_LANG_LINK_MODE: clarify usage.
2025-03-02 13:57:30 +01:00
Matthew Woehlke
76e11bd4ea
Help: Fix find_package documentation about CPS and COMPONENTS
...
The recent addition of component handling for CPS neglected to update
the documentation of how find_package handles component requests when
importing from CPS. Make those changes now.
2025-02-28 17:00:00 -05:00
Brad King
62321f299c
Merge topic 'cpack-rpm-docs' into release-4.0
...
7ae85338ca CPack/RPM: Normalize documentation wording about quoting requirements
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !10402
2025-02-28 16:21:31 -05:00
Balazs Kosaras
7ae85338ca
CPack/RPM: Normalize documentation wording about quoting requirements
...
The phrase "requires string" refers to the RPM `Requires` tag, but it
had been copied from the description of `CPACK_RPM_PACKAGE_REQUIRES`
without adjusting the text.
2025-02-28 12:06:39 -05:00
Brad King
5dd973f900
ci: Convert sunos packaging jobs to build sunos-{x86_64,sparc64} binaries
2025-02-27 16:35:09 -05:00
Martin Duffy
4e7b37cad3
instrumentation: Quote command arguments to preserve separation
...
Fixes : #26702
2025-02-24 13:11:19 -05:00
Brad King
12e76f1e26
Merge branch 'release-3.31' into release-4.0
2025-02-24 11:20:20 -05:00
Brad King
859ca5c4d7
CMake 3.31.6
2025-02-24 10:53:17 -05:00
Brad King
db1478d145
Merge branch 'release-3.31' into release-4.0
2025-02-24 10:44:06 -05:00
Brad King
1e2e9ceccf
Merge branch 'release-3.30' into release-3.31
2025-02-24 10:43:52 -05:00
Brad King
2bd6fbe1b0
CMake 3.30.8
2025-02-24 10:09:52 -05:00
Brad King
1d606df7cc
Merge topic 'policy-version-env' into release-4.0
...
33856b1d62 Add CMAKE_POLICY_VERSION_MINIMUM environment variable
04721acc6c Tests: Cover CMAKE_POLICY_VERSION_MINIMUM in initial cache script
729470ff6d Tests: Cover CMAKE_POLICY_VERSION_MINIMUM in script mode
6cd10ffed7 Tests: Cover CMAKE_POLICY_VERSION_MINIMUM as cache entry
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Acked-by: John Parent <john.parent@kitware.com >
Merge-request: !10376
2025-02-21 09:12:59 -05:00
Brad King
33856b1d62
Add CMAKE_POLICY_VERSION_MINIMUM environment variable
...
Extend commit 1a35351125 (Add CMAKE_POLICY_VERSION_MINIMUM to help
configure outdated projects, 2025-02-13, v4.0.0-rc1~12^2) with an
environment variable to initialize the cache entry. That will make it
easier to use when `cmake` is invoked under layers of scripting.
Closes : #26715
2025-02-20 16:55:53 -05:00
Brad King
77a742b088
Help: add_dependencies requires at least two arguments
...
Update the documentation to match the implementation.
2025-02-20 08:25:58 -05:00
Brad King
ccfa403859
Merge topic 'instrumentation-presets-hooks' into release-4.0
...
45d3ffaa95 instrumentation: Use auto for variables holding closures
d75ccd9f8d instrumentation: Fix docs for ctest --collect-instrumentation option
a2232db802 instrumentation: Make hooks compatible with presets
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Merge-request: !10352
2025-02-18 09:49:44 -05:00
Brad King
d40e1a0682
Merge topic 'policy_max-docs' into release-4.0
...
48095c623f Help/cmake_minimum_required: clarify policy_max `versionadded` note
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !10363
2025-02-18 09:43:23 -05:00
Ben Boeckel
48095c623f
Help/cmake_minimum_required: clarify policy_max versionadded note
...
While the prose clarifies this below, a quick glance at the docs can
make one believe that `...3.10` has no sensible use. However, it is
still useful to tell CMake 3.12 and up that at least 3.10 behavior is
accepted.
2025-02-18 06:20:32 +01:00
Martin Duffy
d75ccd9f8d
instrumentation: Fix docs for ctest --collect-instrumentation option
2025-02-17 11:03:28 -05:00
Brad King
b5374e0405
Help: Fix typo in 4.0 release notes
...
Reported-by: Craig Scott <craig.scott@crascit.com >
2025-02-17 10:35:20 -05:00
Brad King
4300d08b20
Merge topic 'instrumentation_cdash' into release-4.0
...
a6d4a9a2ae ctest: Include cmake instrumentation data in XML files
85a63143ed instrument: don't report target=TARGET_NAME
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !10332
2025-02-16 10:58:11 -05:00
Brad King
28f1da4b25
ci: Add jobs to build sunos-{i386,sparc} binaries
2025-02-15 07:28:07 -05:00
Zack Galbreath
a6d4a9a2ae
ctest: Include cmake instrumentation data in XML files
2025-02-15 06:25:12 -05:00
Zack Galbreath
85a63143ed
instrument: don't report target=TARGET_NAME
...
Remove the erroneous default target name when instrumenting
custom commands.
2025-02-15 06:21:58 -05:00
Brad King
47689e9253
Merge topic 'policy-version-var' into release-4.0
...
1a35351125 Add CMAKE_POLICY_VERSION_MINIMUM to help configure outdated projects
d723198539 Help: De-duplicate policy version documentation
e5d29e9e00 Help: Drop cmake_minimum_required pre-2.4 behavior
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Merge-request: !10343
2025-02-14 09:32:33 -05:00
Brad King
1a35351125
Add CMAKE_POLICY_VERSION_MINIMUM to help configure outdated projects
...
Provide packagers and end users with a way to try configuring projects that
have not been updated to set their policy version to a supported level.
Closes : #26698
2025-02-13 14:00:26 -05:00
Brad King
d723198539
Help: De-duplicate policy version documentation
2025-02-13 12:36:54 -05:00
Brad King
e5d29e9e00
Help: Drop cmake_minimum_required pre-2.4 behavior
...
The long outdated pre-2.4 compatibility behavior is no longer relevant
since CMake 4.0 dropped support for pre-3.5 compatibility.
2025-02-13 12:22:21 -05:00
Alex Neundorf
8905157694
Help: Link CMAKE_CURRENT_LIST_(DIR|FILE|LINE) to/from FUNCTION-equivalents
2025-02-13 09:46:20 -05:00
Brad King
3f2386db2b
Merge topic 'find-cps-version' into release-4.0
...
3e6466eb16 find_package: Honor version requests when finding CPS packages
7a0e698384 find_package: Fix CPS version parsing
35a7ed125b find_package: Fix reporting of rejected CPS files' version
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Merge-request: !10297
2025-02-13 09:33:04 -05:00
Brad King
f45c1384cb
Merge topic 'doc-header-only' into release-4.0
...
2d5f2c9311 Help: Make cmake-buildsystem(7) header-only examples consistent
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !10333
2025-02-13 09:30:55 -05:00
Matthew Woehlke
3e6466eb16
find_package: Honor version requests when finding CPS packages
...
Teach find_package to check a CPS package's version (when provided)
against a version request given to the find_package invocation.
2025-02-12 11:36:41 -05:00
Brad King
1d274d34b9
Merge topic 'instrumentation-build-snippet' into release-4.0
...
c8e319d08c instrumentation: Add experimental notes to docs
f777af7734 instrumentation: Update docs for available snippets
2299b2fcab instrumentation: Add build snippet
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: buildbot <buildbot@kitware.com >
Merge-request: !10328
2025-02-12 09:43:17 -05:00
Brad King
33b3fb0876
Merge topic 'help-find-library' into release-4.0
...
4b7ed0ec79 Help: Clarify find_library() behavior for suffixed libraries
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !10322
2025-02-12 09:30:30 -05:00
Brad King
ae103956b0
Merge topic 'doc-target_link_libraries' into release-4.0
...
1d07da0912 Help: Clarify context of target_link_libraries pre-4.0 behavior documentation
b7dc28cb8c Help: Drop target_link_libraries redundant prose on debug/optimized keywords
b4bac3018f Help: Drop target_link_libraries mention of CMP0003 and CMP0004
639eee1a0c Help: Call out target_link_libraries legacy signatures earlier
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: Yegor Yefremov <yegorslists@googlemail.com >
Merge-request: !10326
2025-02-12 09:28:50 -05:00
Patrik Huber
2d5f2c9311
Help: Make cmake-buildsystem(7) header-only examples consistent
...
Extend commit 93696d0f2e (Help: Restore cmake-buildsystem(7) header-only
library example, 2023-01-13, v3.25.2~3^2) to cover a second part of the
example from commit 4b25a0d512 (Help/manual: Update header-only library
example, 2022-04-22, v3.24.0-rc1~220^2).
Issue: #24319
2025-02-12 09:14:41 -05:00
Brad King
7e5a80c7ff
Merge topic 'execute_process-cmd-bat' into release-4.0
...
b902fbd0c6 execute_process: Clarify when a Windows command interpreter is used
e388ed687a execute_process: Improve invocation of .cmd/.bat with spaces
Acked-by: Kitware Robot <kwrobot@kitware.com >
Acked-by: Nikita Nemkin <nikita@nemkin.ru >
Acked-by: Alexey Edelev <alexey.edelev@qt.io >
Merge-request: !10321
2025-02-12 09:10:03 -05:00
Martin Duffy
c8e319d08c
instrumentation: Add experimental notes to docs
2025-02-11 13:47:56 -05:00
Martin Duffy
f777af7734
instrumentation: Update docs for available snippets
2025-02-11 13:47:20 -05:00
Martin Duffy
2299b2fcab
instrumentation: Add build snippet
...
Adds a new snippet generation for recording the full time spent waiting for
`ninja` or `make` invocations to finish.
2025-02-11 13:31:28 -05:00
Brad King
1d07da0912
Help: Clarify context of target_link_libraries pre-4.0 behavior documentation
...
Update paragraphs that exist only to document pre-4.0 behavior to
explicitly state so.
Fixes : #26679
2025-02-11 09:30:57 -05:00
Brad King
b7dc28cb8c
Help: Drop target_link_libraries redundant prose on debug/optimized keywords
...
This is already documented in the overview, and does not need to be
repeated for a specific signature.
Issue: #26679
2025-02-11 09:30:55 -05:00
Brad King
b4bac3018f
Help: Drop target_link_libraries mention of CMP0003 and CMP0004
...
These policies have been removed by CMake 4.0 and have not been
practically relevant in many years.
Issue: #26679
2025-02-11 09:24:07 -05:00
Brad King
639eee1a0c
Help: Call out target_link_libraries legacy signatures earlier
2025-02-11 09:23:06 -05:00
Nikita Nemkin
4b7ed0ec79
Help: Clarify find_library() behavior for suffixed libraries
...
The name is used as-is only if it contains a recognized suffix.
Clarify this behavior and add links to the relevant variables.
Fixes : #18401
2025-02-11 08:50:59 -05:00
Brad King
b2674f3b38
Merge topic 'instrumentation-doc-fixes' into release-4.0
...
32e9d27c88 instrumentation: Remove undocumented binaryDir field from snippets
d88458b5ea instrumentation: Improve documentation for CMake Instrumentation
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !10320
2025-02-11 07:46:46 -05:00
Brad King
2baab9b99f
Merge topic 'print-presets-log-level' into release-4.0
...
5303ad3823 Presets: Only print presets variables for verbose log level or higher
Acked-by: Kitware Robot <kwrobot@kitware.com >
Merge-request: !10315
2025-02-11 07:45:21 -05:00
Brad King
b902fbd0c6
execute_process: Clarify when a Windows command interpreter is used
...
We've always executed `.bat` and `.cmd` files through `cmd /c`, but
previously it was implicit in undocumented `CreateProcessW` behavior.
2025-02-11 07:26:56 -05:00