On 1/25/2012 9:30 AM, Matthew Kenworthy wrote:

Can any one of the PDL developers explain what the theory is behind
the documentation tree in PDL/Doc/ ?

I can work out that most modules have functions that are documented in
POD in their respective .pm files, but from what I can gather, there
are some tweaks to the POD format to autogenerate signatures and the
such.

The scripts in Doc/ seem pretty complicated for what *seems* to be a
simple job - pull out the POD, convert to Man and HTML pages, and to
set up pdldoc in the right place.

What am I missing?

The main thing is that the scripts include modified
versions of some now-standard Pod modules.  As part
of the PDL cleanup, I have planned to remove our
internal (and now outdated/bogus) copies and update
the code to use the current standard Pod modules.

These fixes will be after PDL-2.4.10.  Are your
questions related to PDL::Book in some way?

Cheers,
Chris

_______________________________________________
Perldl mailing list
[email protected]
http://mailman.jach.hawaii.edu/mailman/listinfo/perldl

Reply via email to