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
LaTeX::Pod(3) User Contributed Perl Documentation LaTeX::Pod(3)

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

 use LaTeX::Pod;

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

"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.

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

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

Returns the parser object.

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

 $pod = $parser->convert;

Returns the computed POD as a string.

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

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.

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

LaTeX::TOM

Steven Schubiger <schubiger@cpan.org>

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/>

2011-08-18 perl v5.32.1
Search for    or go to Top of page |  Section 3 |  Main Index

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