Commit Graph

6252 Commits

Author SHA1 Message Date
Brad King
7b1ab24d79 Merge topic 'doc-compiler-id-table'
a8430527f3 Help: `CMAKE_<LANG>_COMPILER_ID` turn code block into table

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7567
2022-08-16 12:58:42 -04:00
Brad King
14aca54c0a Merge topic 'doc-cmake-cli-options'
0224576995 Help: Replace `cmake -P` option mentions w/ Sphinx role
1b94770f27 Help: Insert link to `cmake --toolchain` option
2c54cd871a Help: Turn items of presets manual page into description list
e2198fd9dc Help: Format `-Werror`/`-Wno-error` in the way it can be referenced
a6070b480f Help: Use placeholder instead of listing choices in option lines
8ba20cb56f Help: Simplify `cmake --log-level` option definition
146e4e6bad Help: Split `ctest` options into groups like `cmake` man page has
4c1008d739 Help: Use `:option:` role to reference `ctest` options
...

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7554
2022-08-16 12:46:26 -04:00
Craig Scott
69d584378f Merge topic 'doc-warning-as-error'
2c6e379c89 Merge branch 'backport-3.24-doc-warning-as-error' into doc-warning-as-error
bba3ec96b0 Help: A missing cross-reference to --compile-no-warning-as-error
2c1a746343 Merge branch 'backport-3.24-doc-warning-as-error' into doc-warning-as-error
680fe820c6 Help: A missing cross-reference to --compile-no-warning-as-error
7ad89f8fb1 Help: List compiler IDs supported by COMPILE_WARNING_AS_ERROR

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7561
2022-08-16 06:57:32 -04:00
Alex Turbov
a8430527f3 Help: CMAKE_<LANG>_COMPILER_ID turn code block into table 2022-08-15 20:37:25 +04:00
Brad King
4befac3b32 Merge topic 'nvtx3'
cd200c6c2d FindCUDAToolkit: nvtx3 target

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7568
2022-08-15 11:26:23 -04:00
Craig Scott
bba3ec96b0 Help: A missing cross-reference to --compile-no-warning-as-error 2022-08-15 11:08:38 -04:00
Brad King
2c1a746343 Merge branch 'backport-3.24-doc-warning-as-error' into doc-warning-as-error 2022-08-15 11:06:59 -04:00
Craig Scott
7ad89f8fb1 Help: List compiler IDs supported by COMPILE_WARNING_AS_ERROR 2022-08-15 11:06:31 -04:00
Brad King
c5f6d93d5e Merge topic 'warning-as-error-ti-compiler'
1cd65dfa0e TI compiler: Add support for COMPILE_WARNING_AS_ERROR target property

Acked-by: Kitware Robot <kwrobot@kitware.com>
Acked-by: Josef Angstenberger <code@jtxa.de>
Merge-request: !7560
2022-08-15 10:51:45 -04:00
Alex Turbov
0224576995 Help: Replace cmake -P option mentions w/ Sphinx role 2022-08-14 09:58:42 +04:00
Alex Turbov
1b94770f27 Help: Insert link to cmake --toolchain option 2022-08-14 09:58:42 +04:00
Alex Turbov
2c54cd871a Help: Turn items of presets manual page into description list
It was an ordinal paragraphs (`<p>`) intermixed with blockquote elements.
2022-08-14 09:58:41 +04:00
Alex Turbov
e2198fd9dc Help: Format -Werror/-Wno-error in the way it can be referenced
Replace mentions of these options in the presets manual page.
2022-08-14 09:58:41 +04:00
Alex Turbov
a6070b480f Help: Use placeholder instead of listing choices in option lines
This avoids any ambiguity with whether the choices are literal
values or not. It also makes the option lines more concise.
2022-08-14 09:58:41 +04:00
Alex Turbov
8ba20cb56f Help: Simplify cmake --log-level option definition 2022-08-14 09:58:41 +04:00
Alex Turbov
146e4e6bad Help: Split ctest options into groups like cmake man page has
Co-Authored-By: Craig Scott <craig.scott@crascit.com>
2022-08-14 09:58:41 +04:00
Alex Turbov
4c1008d739 Help: Use :option: role to reference ctest options 2022-08-14 09:58:41 +04:00
Alex Turbov
c401fc5dee Help: Simplify optional repeating option
Similar form has already been used in the `ctest -M <mode> [-T <step>]...`
synopsis and looks quite clean w/o extra characters.
2022-08-14 09:58:41 +04:00
Alex Turbov
28ecfd1690 Help: Short options first, then long, then Windows style 2022-08-14 09:58:41 +04:00
Alex Turbov
57f23fa8fc Help: {<…> | <…>}<…|…>
The form of alternative names for "placeholders" has been used already
(e.g., `<file|dir>` in the `cmake(1)` manual).
2022-08-14 09:58:41 +04:00
Alex Turbov
5a20d4c250 Help: Consistent spaces in option args 2022-08-14 09:58:41 +04:00
Alex Turbov
798834ef63 Help: <f><file> for --help* option descriptions 2022-08-14 09:58:41 +04:00
Craig Scott
db9453bbcf Merge topic 'doc-MSVC_RUNTIME_LIBRARY-init'
c1b07ca9da Help: MSVC_RUNTIME_LIBRARY is initialized from associated variable

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7566
2022-08-14 01:13:51 -04:00
Raul Tambre
cd200c6c2d FindCUDAToolkit: nvtx3 target
nvtx3 is a header-only replacement for the previous shared library
implementations.

I implemented it as a separate target since while the header names match and
ideally it should be API compatible, forcing its include directory into the old
target would lengthen the include search path and could cause confusion or
possible build differences for projects using multiple build systems. This
keeps it explicit as a developer opt-in.

Implements: #21377
Resolves: #23835
2022-08-13 23:52:42 +03:00
Craig Scott
c1b07ca9da Help: MSVC_RUNTIME_LIBRARY is initialized from associated variable
The CMAKE_MSVC_RUNTIME_LIBRARY variable docs mention that it
initializes the MSVC_RUNTIME_LIBRARY target property, but the
property's docs was missing any mention of the variable.
2022-08-13 09:11:35 +10:00
Craig Scott
1cd65dfa0e TI compiler: Add support for COMPILE_WARNING_AS_ERROR target property 2022-08-12 08:27:19 +10:00
Cristian Adam
62cd3904bf variable: Set LINUX variable on Linux target systems
Fixes: #23840
2022-08-12 07:20:05 +10:00
Brad King
1493ed10a1 Merge topic 'doc-ctest-multi-built-target'
ce58311b31 Help: --build-target can be repeated in ctest --build-and-test mode

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7555
2022-08-10 09:24:02 -04:00
Brad King
7e580e48a4 Merge topic 'tutorial_genExp_rearrange'
ccba87b05b Tutorial: Move step 10 to step 4

Acked-by: Kitware Robot <kwrobot@kitware.com>
Acked-by: buildbot <buildbot@kitware.com>
Merge-request: !7506
2022-08-10 09:21:32 -04:00
Craig Scott
ce58311b31 Help: --build-target can be repeated in ctest --build-and-test mode 2022-08-10 16:40:00 +10:00
Alex Turbov
7f4b90a3a6 Help: Fix ctest options description
Missed empty line after `.. option::` and the next paragraph.
2022-08-10 00:46:24 +04:00
Brad King
5d76ff6019 Help: Fix formatting of CMAKE_EXPERIMENTAL_CXX_MODULE_CMAKE_API notes 2022-08-09 13:05:34 -04:00
Markus Ferrell
ccba87b05b Tutorial: Move step 10 to step 4
Shifts steps 4-9 to 5-10.
2022-08-08 17:15:48 -04:00
Brad King
ed86192cd8 Merge topic 'doc-markup-program-options'
a6abdf6c8f Help: Consistent options declaration -- short first, then long
f4563f05db Help: Value for `--graphviz=` option actually is mandatory
04843d743e Help: Replace a bunch of more ``--option`` to `:option:` role
09446266ee Help: Replace mentions of ``-D`` option with :option:`-D` role
b57f27b087 Help: Replace mentions of ``-T`` and ``-A`` options with role
d25b232dee Help: Replace mentions of ``-G`` option with :option:`-G` role
63940e1cab Help: Replace mentions of ``-C`` option with :option:`-C` role
183a49cbfe Help: Replace mentions of ``-S`` option with :option:`-S` role
...

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7544
2022-08-08 09:39:41 -04:00
Brad King
9274bdff27 Merge topic 'find_package-one-more-path'
19366408fe cmFindPackageCommand: Protect overrides of `cmDirectoryListGenerator`
e55c154c5b cmFindPackageCommand: Add one more search path

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7542
2022-08-05 08:53:09 -04:00
Alex Turbov
a6abdf6c8f Help: Consistent options declaration -- short first, then long 2022-08-04 19:34:45 +04:00
Alex Turbov
f4563f05db Help: Value for --graphviz= option actually is mandatory
Before it was `[file]` that AFAIK means optional.
2022-08-04 19:34:45 +04:00
Alex Turbov
04843d743e Help: Replace a bunch of more `--option to :option:` role 2022-08-04 19:34:45 +04:00
Alex Turbov
09446266ee Help: Replace mentions of `-D option with :option:-D` role 2022-08-04 19:34:45 +04:00
Alex Turbov
b57f27b087 Help: Replace mentions of `-T and -A` options with role 2022-08-04 19:34:45 +04:00
Alex Turbov
d25b232dee Help: Replace mentions of `-G option with :option:-G` role 2022-08-04 19:34:45 +04:00
Alex Turbov
63940e1cab Help: Replace mentions of `-C option with :option:-C` role 2022-08-04 19:34:44 +04:00
Alex Turbov
183a49cbfe Help: Replace mentions of `-S option with :option:-S` role 2022-08-04 19:33:42 +04:00
Alex Turbov
765d2768f1 Help: Turn some mentions of options into links on executables man page 2022-08-04 19:32:56 +04:00
Alex Turbov
8ffc5e1bbb Help: Use option directive for the executables manual pages
It'll allow to refer to a particular option of any executable.

There are two "fake" programs added for the CMake script mode (`cmake_P`)
and CMake CLI Tool mode (`cmake_E`).
2022-08-04 19:15:06 +04:00
Alex Turbov
e55c154c5b cmFindPackageCommand: Add one more search path
The `PREFIX/(Foo|foo|FOO).*/(cmake|CMake)/(Foo|foo|FOO).*/` search
path is the similar to the one already exists
`PREFIX/(Foo|foo|FOO).*/(lib/ARCH|lib*|share)/cmake/(Foo|foo|FOO).*/`.
2022-08-04 09:41:59 -04:00
Brad King
ddfccc36de Merge topic 'doc-CPACK_NUGET_PACKAGE_REQUIRE_LICENSE_ACCEPTANCE'
02621e66d0 Help: Add CPACK_NUGET_PACKAGE_REQUIRE_LICENSE_ACCEPTANCE docs

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7541
2022-08-04 09:39:42 -04:00
Brad King
d4ec1ded39 Merge topic 'fetchcontent-set-CMAKE_VERIFY_INTERFACE_HEADER_SETS'
2a9cc3e8e8 FetchContent: Disable header set verification for dependencies

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7535
2022-08-04 09:34:48 -04:00
Brad King
3a38f6c618 Merge topic 'fetchcontent-set-CMAKE_VERIFY_INTERFACE_HEADER_SETS' into release-3.24
2a9cc3e8e8 FetchContent: Disable header set verification for dependencies

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7535
2022-08-04 09:34:47 -04:00
Brad King
2ed7d6cee7 Merge topic 'doc-find_package-typo'
5635d33656 Help: Fix reST syntax typo in find_package docs

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7540
2022-08-04 09:33:50 -04:00