Tag definition

Now the tags can be declared really.

Tag declarations are expected in a global hash named %tags. Each key is the name of a tag, while the tag descriptions are nested structures stored as related values.

    # tag declarations
  
    %tags=(
           EMPHASIZE => {...}
  
           COLORIZE  => {...},
  
           FONTIFY   => {...},
  
           ...
          );

Please note that there are no tag namespaces. Although Perl modules are used to define the tags, tags declared by various PerlPoint::Tags::Xyz share the same one "global scope", because a PerlPoint document author simply uses all tag names the same way, regardless where they were defined. This means that different tags should be named different.

Each tag description consists of several parts:

• Base definition
• Parsing hooks
• Post-parsing hooks
• Using foreign definitions

Most of these parts are optional.