Files
cmake/Help/prop_rule/GLOBAL.rst
T
2026-09-20 11:43:10 +02:00

21 lines
745 B
ReStructuredText

GLOBAL
------
.. versionadded:: 4.5
Indication of whether a rule is globally visible.
The boolean value of this property is true for rules created with the
``GLOBAL`` options to :command:`add_custom_rule()`.
For rules created without the additional option ``GLOBAL`` this is false.
However, setting this property to true promotes that rule to global scope. This
promotion can only be done in the same directory where the rule was created.
.. note::
Once an rule has been made global, it cannot be changed back to
non-global. Therefore, if a project sets this property, it may only
provide a value of true. CMake will issue an error if the project tries to
set the property to a non-true value, even if the value was already false.