Gtk2::Ex::PodViewer::Parser - a custom POD Parser for Gtk2::Ex::PodViewer.
$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);
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.
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.
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.
E<gt>
The $LINK_TEXT_TEMPLATE class variable contains a string that is used to generate link text for POD links for the form
$LINK_TEXT_TEMPLATE
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.
gettext()
{section}
{document}
foo
bar
Gtk2::Ex::PodViewer
Pod::Parser
Locale::gettext
Gavin Brown, Torsten Schoenfeld and Scott Arrington.
(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.
To install Gtk2::Ex::PodViewer, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Gtk2::Ex::PodViewer
CPAN shell
perl -MCPAN -e shell install Gtk2::Ex::PodViewer
For more information on module installation, please visit the detailed CPAN module installation guide.