NAME¶
DhMakePerl::PodParser - internal helper module for DhMakePerl
SYNOPSIS¶
DhMakePerl::PodParser is used by DhMakePerl to extract some information from the
module-to-be-packaged. It subclasses 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 ocurred 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 interiorsquence occureds 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.
SEE ALSO¶
Pod::Parser
AUTHOR¶
- Paolo Molaro
- Documentation added by Gunnar Wolf and Damyan Ivanov
COPYRIGHT & LICENSE¶
- Copyright (C) 2001, Paolo Molaro
<lupus@debian.org>
- Copyright (C) 2008, Gunnar Wolf
<gwolf@debian.org>
- Copyright (C) 2008, Damyan Ivanov
<dmn@debian.org>
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License version 2 as published by the Free
Software Foundation.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
Street, Fifth Floor, Boston, MA 02110-1301 USA.