Writing a tag module

Now when your tags are designed, you need to define them by a module in the PerlPoint::Tags namespace and make it a subclass of PerlPoint::Tags:

    # declare a tag declaration package
  
    package PerlPoint::Tags::New;
  
    # declare base "class"
  
    use base qw(PerlPoint::Tags);

The base module PerlPoint::Tags contains a special import() method which arranges that the parser learns new tag definitions when a tag module is loaded by use. PerlPoint::Tags is provided as part of the converter framework PerlPoint::Package.

It is recommended to have a "top level" tag declaration module for each PerlPoint converter, so there could be a PerlPoint::Tags::HTML, a PerlPoint::Tags::Latex, PerlPoint::Tags::SDF, a PerlPoint::Tags::XML and so on. (These modules of course may simply invoke lower level declarations if appropriate.)

To complete the intro, configure variable handling:

    # pragmata
  
    use strict;
    use vars qw(%tags %sets);

%tags and %sets are important variables used by convention. They will be explained in the next sections.