25 lines
993 B
Text
25 lines
993 B
Text
|
POD::Abstract provides a means to load a POD (or POD compatible) document
|
||
|
|
without direct reference to it's syntax, and perform manipulations on the
|
||
|
|
abstract syntax tree.
|
||
|
|
|
||
|
|
This can be used to support additional features for POD, to format output,
|
||
|
|
to compile into alternative formats, etc.
|
||
|
|
|
||
|
|
WHY?
|
||
|
|
====
|
||
|
|
|
||
|
|
If you've ever asked yourself "What does Pod do for me?", this module is
|
||
|
|
intended to answer that question.
|
||
|
|
|
||
|
|
While Pod looks like a simple format, the specification calls for a number
|
||
|
|
of special cases to be handled, and that makes any software that works on
|
||
|
|
Pod as text more complex than it needs to be.
|
||
|
|
|
||
|
|
In addition to this, Pod does not lend itself to a natural structured model.
|
||
|
|
This makes it difficult to manipulate without damaging the validity of the
|
||
|
|
document.
|
||
|
|
|
||
|
|
Pod::Abstract solves these problems by loading the document into a structured
|
||
|
|
tree, and providing consistent traversal, searching, manpulation and
|
||
|
|
re-serialisation. Pod related utilities are easy to write using Pod::Abstract.
|