CMake/Help/diagnostic/CMD_STRICT.rst at master - CMake - Gitea: Git with a cup of tea

dilim/CMake

mirror of https://github.com/Kitware/CMake.git synced 2026-08-09 17:18:18 +00:00

Files

Matthew Woehlke 00959286b9 Diagnostics: Warn about non-target directives

Introduce `CMD_STRICT` to act as a parent for warnings about allowed but
disrecommended usage. Introduce a warning that discourages use of
non-target directives (which modify the build environment for the entire
[sub]tree). Add notes to the official documentation recommending use of
target-specific alternatives. This has been accepted wisdom for quite
some time, but only some of the affected commands made any mention of
this in the documentation.

2026-07-28 11:38:20 -04:00

15 lines

318 B

ReStructuredText

Raw Permalink Blame History

 CMD_STRICT
 ----------
 .. versionadded:: 4.5
 .. diagnostic::
   :default: ignore
   :parent: CMD_AUTHOR
   Control diagnostics related to allowed but disrecommended usage.  This is
   the parent of the following diagnostics:
   * :diagnostic:`CMD_INSTALL_ABSOLUTE_DESTINATION`
   * :diagnostic:`CMD_NON_TARGET_DIRECTIVE`