Files
cmake/Help/command/include/NON_TARGET_NOTE_BODY.rst
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

7 lines
402 B
ReStructuredText

Use of the |command_name| command for new development is discouraged.
Unencapsulated alterations to the build environment can have unintentionally
broad effect, potentially resulting in unnecessary build dependencies.
Additionally, the |command_name| command cannot be used to express interface
usage requirements. It is recommended that new development use the
|target_command_name| command instead.