Re: problems in several man pages you maintain

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>