Dear all,

after fiddling with details for a long time, I'm now confident enough to
upload Pod-Compiler-0.10.tar.gz to CPAN. Should reach your favorite mirror
soon.

What is it? This package, based on Pod::Parser and Tree::DAG_Node compiles
a POD document into an object tree, printing (or not) many diagnostic
messages in case the input is malformed. There are many convenient methods
to handle the result, for example for converting it to different output
formats. There are even some *::collection objects that define useful
methods for a bunch of e.g. Pod nodes (=hyperlink destinations) and entire
documents. There is an interface to Storable to conveniently store and
retrieve the object tree. See the POD in Pod::Compiler for more details.

There is a sample application included, podlint. As its name suggests, it
beautifies existing POD documents and cleans up most errors (hopefully).

My next plans are to bugfix this package and in parallel build a
Pod->FrameMaker converter. My existing Marek::Pod::HTML will be updated to
use this package as well.

I know that Pod::Tree is very similar to this one, but I believe that
reusing Pod::Parser and Tree::DAG_Node is a major advantage over the
standalone Pod::Tree.

Feel free to testdrive the package (I've tested it only on Solaris/Sparc
and Linux, with Perl 5.005.03 and 5.6.0 so far) and send comments. Hope
you'll find it useful!

All the best,

Marek

Reply via email to