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.