GLOBAL

Added in version 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 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.