Home  |  Linux  | Mysql  | PHP  | XML
From:Eric S. Raymond Date:Mon Jan  1 17:35:32 2007
Subject:Re: problems in several man pages you maintain
Sébastien Aperghis-Tramoni <maddingue@free.fr>:
> 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>
Navigate in group perl.documentation at sever nntp.perl.org
Previous Next




  
© No Copyright
You are free to use Anything
Site Maintained by PHP Developer
Powered By PHP Consultants