LMPX.COM |
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 |