Sébastien Aperghis-Tramoni <[EMAIL PROTECTED]>: > Perl documentation is maintained using the POD format. Unix manual > pages in nroff format are generated from the POD. Therefore patches > to the resulting nroff are not very useful. Plus, if what you want is > to convert the documentation to DocBook, it's better to use a program > or module which uses the POD as the source, not the nroff. Something > like Pod::DocBook or using Pod::Simple::XMLOutStream and a small XSLT > to transform the XML stream to DocBook for example. > > » http://search.cpan.org/dist/Pod-DocBook/ > » http://search.cpan.org/dist/Pod-Simple/
I'm aware of this background. Sometimes, though, errors in generated pages are traceable to POD errors that should be fixed at that level. -- <a href="http://www.catb.org/~esr/">Eric S. Raymond</a>