The file(COPY_FILE) sub-command is closely related to the
file(COPY) sub-command. Move the former to just before the
latter for improved continuity. The file(RENAME) sub-command is
also somewhat related to file(COPY_FILE), so it was also moved to
keep it just before file(COPY_FILE).

The file(MAKE_DIRECTORY) sub-command was also moved to just
before the file(REMOVE) and file(REMOVE_RECURSE) sub-commands
to keep them together and improve logical flow of operations.

Documentation added by

* commit 4f4f2028 (Help: Add documentation for buildPresets and
                     testPresets, 2021-01-13, v3.20.0-rc1~51^2~7)
* commit 676ecf0d (cmake-presets: Add build and test presets,
                     2020-12-14, v3.20.0-rc1~51^2~6)

used square brackets in the `cmake --build` signature to indicate
non-optional alternatives, which is not a typical convention.
A common convention is to use parentheses instead, but in this
case it is probably clearer to list the two signatures separately.

Fixes: #22413

Sergio Martins authored 3 years ago and Brad King committed 3 years ago

Since commit 8bc5c896 (CMakePresets.json: Add the ability to
conditionally disable presets, 2021-03-10, v3.21.0-rc1~464^2)
the example requires presets version 3 support, which is not
available until CMake 3.21.  CMake 3.20.0 can't open v3 presets.
Make cmakeMinimumRequired compatible with the example's version.

Michael Hirsch authored 3 years ago and Brad King committed 3 years ago

Extend the documentation added by commit 96a70401 (project: Define
variables indicating whether project is top level, 2021-03-24,
v3.21.0-rc1~443^2) to give some examples of how the variables are set in
each context.

Note that some CUDA C++ language standard levels were added before any
compilers actually supported them.  In such cases, the value of
`CUDA_STANDARD` gracefully degrades to the highest supported by the
compiler (unless `CUDA_STANDARD_REQUIRED` is enabled).  Therefore we can
document support for each value based on when CMake learned of it.

Duplicated textual patterns are factored out to make the text
more readable. The POST_INCLUDE_FILES and POST_EXCLUDE_FILES
were also previously missing from the main syntax block for
install(RUNTIME_DEPENDENCY_SET).

In particular, mention the mutually exclusive nature with the
COMPONENT option. Fix the inconsistent way the versionadded
details were added for that text too.

scivision authored 3 years ago and Brad King committed 3 years ago

Issue: #22366

Extend the list of project types added by commit a82eb539 (Help:
Describe the type of Visual Studio projects that can be generated,
2018-08-04, v3.13.0-rc1~227^2) to mention that Fortran projects are
supported with Intel compiler integration.

Alex Sweet authored 3 years ago and Brad King committed 3 years ago

RPM 4.11.3 for el7 contains backported support for the RPM weak dep tags.
It only supports querying those tags, but rpmbuild can not make use of them.
Since CPack relies on rpmbuild --querytags to check for support, this
commit switches to rpm --suggests to check for support of weak
dependencies.

Fixes: #22350

Fixes: #22353

Avoid implying that the field is always present.

Fixes: #22352

This was missed in the review of !4150, but was noticed during
discussion of #22353.

Fixes: #22339

In a document that says "New in version 3.14", we do not need any blocks
that say "New in version 3.8".

Make it clear that the notes for these patch releases were not
forgotten, and that there were simply no changes to documented features
or interfaces.

Heiko Thiel authored 3 years ago and Brad King committed 3 years ago

Fixes: #18856

Extend the change from commit 9e5bbb69 (Tutorial: Add captions for
code blocks, 2021-06-11) to also add a Sphinx named target to code
blocks.  Name each target after the change the code block makes.

Release versions do not have the development topic section of
the CMake Release Notes index page.

Josef Angstenberger authored 3 years ago and Brad King committed 3 years ago

- Use inline literals for all code fragments and names.
- Add missing console code-blocks.
- Always use c++, not c as code language.

Josef Angstenberger authored 3 years ago and Brad King committed 3 years ago

Fixes: #21737

Run the script:

    Utilities/Sphinx/update_versions.py --since v3.20.0 --overwrite

Manually remove directives generated in documents for long-existing
features for which documentation was added.

Add section headers similar to the 3.20 release notes and move each
individual bullet into an appropriate section.  Revise a few bullets.

Run the `Utilities/Release/consolidate-relnotes.bash` script to move
notes from `Help/release/dev/*` into `Help/release/3.21.rst`.

Fixes: #22302

Issue: #22297