Merge from vendor branch TNF:
[pkgsrcv2.git] / devel / p5-Attribute-Lexical / DESCR
1 This module manages attributes that can be attached to subroutine and
2 variable declarations. Although it can be used directly, it is mainly
3 intended to be infrastructure for modules that supply particular attribute
4 semantics.
5
6 Meanings are assigned to attributes by code which is usually supplied by
7 modules and which runs at compile time. The built-in mechanism for attribute
8 control is awkward to use, difficult in particular to enable multiple
9 attributes supplied by different modules, and it scopes attribute meanings
10 according to the package of the object to which attributes are being
11 applied. This module is intended to overcome these limitations.
12
13 This module supplies a simple pragma to declare an attribute, associating
14 the attribute's name with a handler function that implements its semantics.
15 The declaration is lexically scoped, lasting only until the end of the
16 enclosing block. A declaration can be overridden, giving an attribute name
17 a different meaning or making it meaningless, in an inner nested block.