Home  |  Linux  | Mysql  | PHP  | XML
From:Sébastien_Aperghis-Tramoni Date:Mon Jan  1 17:25:02 2007
Subject:Re: problems in several man pages you maintain
esr@thyrsus.com wrote:

> This is automatically generated email about problems in a man page  
> for which
> you appear to be responsible.  If you are not the right person or  
> list, tell
> me and I will attempt to correct my database.
>
> See http://catb.org/~esr/doclifter/problems.html for details on how  
> and
> why these patches were generated.  Feel free to email me with any  
> questions.
> Note: These patches do not change the mod date of any manual page.   
> You
> may wish to do that by hand.

Hello,

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/

-- 
Sébastien Aperghis-Tramoni

Close the world, txEn eht nepO.


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