DhMakePerl::PodParser(3pm)

DhMakePerl::PodParser3pm

Internal helper module for dhmakeperl

Usage

DhMakePerl::PodParser is used by DhMakePerl to extract some information from the module-to-be-packaged. It sub-classes from Pod::Parser - Please refer to it for further documentation.

Methods

set_names

Defines the names of the sections that should be fetched from the POD

get

Gets the contents for the specified POD section. The single argument should be one of the values given to "set_names".

cleanup

Empties the information held by the parser object

command

Overrides base class' Pod::Parser command method.

Gets each of the POD's commands (sections), and defines how it should react to each of them. In this particular implementation, it basically filters out anything except for the "=head" sections defined in "set_names".

add_text

Hands back the text it received as it occurred in the input stream (see the Pod::Parser's documentation for verbatim, textblock and interior_sequence).

Content is ignored if more than 15 lines away from the section start.

verbatim

Called by Pod::Parser for verbatim paragraphs. Redirected to "add_text".

textblock

Called by Pod::Parser for ordinary text paragraphs. Redirected to "add_text".

interior_sequence

interior_sequence() is called by Pod::Parser when, eh, an interior sequence occurs in the text. Interior sequences are things like I<...>.

This implementation decodes "gt", "lt", "sol", "verbar" and numeric character codes, all used by "E" escape.

Releases

8 releases since Debian 6.0 (Squeeze); the text changed 7 times.

  1. 6.0
  2. 7
  3. 8
  4. 9
  5. 10
  6. 11
  7. 12
  8. 13

Author

Paolo Molaro
Documentation added by Gunnar Wolf and Damyan Ivanov

From dh-make-perl 0.128 in Debian 13 (Trixie). Parsed by carta from the page's man source.