NAME¶
Gtk2::Ex::PodViewer::Parser - a custom POD Parser for Gtk2::Ex::PodViewer.
SYNOPSIS¶
$Gtk2::Ex::PodViewer::Parser::LINK_TEXT_TEMPLATE = '{section} in the {document} manpage';
my $parser = Gtk2::Ex::PodViewer::Parser->new(
buffer => $Gtk2TextView->get_buffer,
);
$parser->parse_from_file($file);
DESCRIPTION¶
Gtk2::Ex::PodViewer::Parser is a custom Pod parser for the Gtk2::Ex::PodViewer
widget. You should never need to use it directly.
It is based on Pod::Parser.
METHODS¶
One neat method not implemented by Pod::Parser is
$parser->parse_from_string($string);
This parses a scalar containing POD data, using IO::Scalar to create a tied
filehandle.
IMPORTABLE FUNCTIONS¶
use Gtk2::Ex::PodViewer::Parser qw(decode_entities);
my $text = decode_entities($pod);
This function takes a string of POD, and returns it with all the POD entities
(eg "E<gt>" => ">") decoded into readable
characters.
VARIABLES¶
The $LINK_TEXT_TEMPLATE class variable contains a string that is used to
generate link text for POD links for the form
LE<lt>foo/barE<gt>
This string is run through the "gettext()" function from
Locale::gettext (if installed) before it is used, so if your application
supports internationalisation, then the string will be translated if it
appears in your translation domain. It contains two tokens,
"{section}" and "{document}", that are replaced with
"foo" and "bar" respectively.
SEE ALSO¶
- •
- Gtk2::Ex::PodViewer
- •
- Pod::Parser
- •
- Locale::gettext
AUTHORS¶
Gavin Brown, Torsten Schoenfeld and Scott Arrington.
COPYRIGHT¶
(c) 2003-2005 Gavin Brown (gavin.brown@uk.com). All rights reserved. This
program is free software; you can redistribute it and/or modify it under the
same terms as Perl itself.