GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  LATEX::POD (3)

.ds Aq ’

NAME

LaTeX::Pod - Transform LaTeX source files to POD (Plain old documentation)

CONTENTS

SYNOPSIS



 use LaTeX::Pod;

 $parser = LaTeX::Pod->new(/path/to/source);
 print $parser->convert;



DESCRIPTION

LaTeX::Pod converts LaTeX sources to Perl’s POD (Plain old documentation). Currently only a subset of the available LaTeX language is supported; see SUPPORTED LANGUAGE SUBSET for further details.

CONSTRUCTOR

    new

The constructor requires that the path to the LaTeX source is defined:



 $parser = LaTeX::Pod->new(/path/to/source);



Returns the parser object.

METHODS

    convert

There is one public method available, namely convert():



 $pod = $parser->convert;



Returns the computed POD as a string.

SUPPORTED LANGUAGE SUBSET

LaTeX currently supported:
o abstracts
o chapters
o sections/subsections/subsubsections
o description, enumerate and itemize lists
o verbatim blocks (and indentation)
o plain text
o bold/italic/code font tags
o umlauts
o newlines
o comments

IMPLEMENTATION DETAILS

The current implementation is based upon LaTeX::TOM (the framework being used for parsing the LaTeX source) and its clear distinction between various types of nodes. As an example, a \chapter command has a separate text associated with it as its content. LaTeX::Pod uses a look-behind mechanism for commands and their corresponding texts since they currently cannot be easily detected without such a mechanism.

Thus LaTeX::Pod was designed with the intention to be context-sensitive aware. This is also being aimed at by eventually registering which type of node has been seen before the current one — useful when constructing logical paragraphs made out of two or more nodes. LaTeX::Pod then finally unregisters the type of node seen when it is no longer required. In addition, a dispatch queue is built internally which is executed after all nodes have been processed.

Considering that the POD format has a limited subset of directives, the complexity of keeping track of node occurences appears to be bearable. Leading and trailing newlines will be removed from the node’s text extracted where needed; furthermore, trailing spaces and tabs will also be purged from each line of POD resulting.

BUGS & CAVEATS

It is highly recommended to ensure that the structure of the LaTeX input file follows the format specification strictly or the parser may <B>notB> succeed.

SEE ALSO

LaTeX::TOM

AUTHOR

Steven Schubiger <schubiger@cpan.org>

LICENSE

This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

See <http://dev.perl.org/licenses/>

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 LATEX::POD (3) 2011-08-18

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.