The first =head1 goes in here

NAME Pod::XML - Module to convert POD to XML SYNOPSIS use Pod::XML; my $parser = Pod::XML->new(); $parser->parse_from_file("foo.pod"); DESCRIPTION This module uses Pod::Parser to parse POD and generates XML from the resulting parse stream. It uses its own format, described below. XML FORMAT The XML format is not a standardised format - if you wish to generate some standard XML format such as docbook, please use a tool such as XSLT to convert between this and that format. The format uses the namespace "http://axkit.org/ns/2000/pod2xml". Do not try and request this URI - it is virtual. You will get a 404. The best way to describe the format is to show you: The first =head1 goes in here Subsequent =head1's create a sect1 Ordinary paragraphs of text create a para tag. Indented verbatim sections go in verbatim tags. =head2's go in sect2 Up to =head4 is supported (despite not really being supported by pod), producing sect3 and sect4 respectively for =head3 and =head4. Bold text goes in a strong tag. Italic text goes in a emphasis tag. Code goes in a code tag. Lists (=over, =item, =back) go in list/item/itemtext tags. The itemtext element is only present if the =item text is not the "*" character. If the first =head1 is "NAME" (like standard perl modules are supposed to be) it takes the next paragraph as the document title. Other standard head elements of POD are left unchanged (particularly, the SYNOPSIS and DESCRIPTION elements of standard POD). Pod::XML tries to be careful about nesting sect's based on the head level in the original POD. Let me know if this doesn't work for you. AUTHOR Matt Sergeant, matt@sergeant.org SEE ALSO Pod::Parser BUGS There is no xml2pod. LICENSE This is free software, you may use it and distribute it under the same terms as Perl itself.