NAME Pod::POM - POD Object Model SYNOPSIS use Pod::POM; my $parser = Pod::POM->new(\%options); # parse from a text string my $pom = $parser->parse_text($text) || die $parser->error(); # parse from a file specified by name or filehandle my $pom = $parser->parse_text($file) || die $parser->error(); # parse from text or file my $pom = $parser->parse($text_or_file) || die $parser->error(); # examine any warnings raised foreach my $warning ($parser->warnings()) { warn $warning, "\n"; } # print table of contents using each =head1 title foreach my $head1 ($pom->head1()) { print $head1->title(), "\n"; } # print each section foreach my $head1 ($pom->head1()) { print $head1->title(), "\n"; print $head1->content(); } # print the entire document as HTML use Pod::POM::View::HTML; print Pod::POM::View::HTML->print($pom); # create custom view package My::View; use base qw( Pod::POM::View::HTML ); sub view_head1 { my ($self, $item) = @_; return "

" . $item->title->present($self) . "

\n\n" . $item->content->present($self); } package main; print My::View->print($pom); DESCRIPTION This module implements a parser to convert Pod documents into a simple object model form known hereafter as the Pod Object Model. The object model is generated as a hierarchical tree of nodes, each of which represents a different element of the original document. The tree can be walked manually and the nodes examined, printed or otherwise manipulated. In addition, Pod::POM supports and provides view objects which can automatically traverse the tree, or section thereof, and generate an output representation in one form or another. See the Pod::POM documentation for further details. PREREQUISITES The Pod::POM module requires Perl 5.005. INSTALLATION The Pod::POM module can be downloaded from any CPAN site: http://www.cpan.org/modules/by-module/Pod/ Installation is as per usual: $ tar zxf Pod-POM-0.15.tar.gz $ cd Pod-POM-0.15 $ perl Makefile.PL $ make $ make test $ make install AUTHOR Andy Wardley VERSION This is version 0.15 of the Pod::POM module. COPYRIGHT Copyright (C) 2000-2002 Andy Wardley. All Rights Reserved. This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.