Re: [gentoo-dev] man pages - converted to DocBook/HTML

[Grant Goodyear <g2boojum@gentoo.org>]

[-- Attachment #1: Type: text/plain, Size: 1555 bytes --]

Vapier wrote: [Mon Nov 29 2004, 09:17:20AM CST]
> On Monday 29 November 2004 02:36 am, Mark Miller wrote:
> > I was wondering if the Gentoo Development team would be interested in
> > a Python script that would automatically convert all the troff and all
> > the other formats of man pages into a DocBook format, which HTML can
> > easily be generated out of, and incorporate this into the Gentoo
> > system.
> 
> for what purpose ?  to have HTML versions of all manpages that exist ?
> -mike

I've always been really impressed with the *BSDs online manpage
databases, but those databases make more sense for the monolithic *BSDs
than they do for the quite heterogeneous Linux distros.  That said, I do
think that it would be nice if we had the man pages for Gentoo tools
available online.  I would suggest using man2html instead of a full
conversion to docbook, however.

Let's see, that would mean converting the man pages in portage,
certainly, as well as those in gentoolkit and gentoolkit-dev.  It looks
like baselayout also includes some man pages, and I believe that I
included man pages for our mailwrapper package.  Are there other
Gentoo-specific man pages that we should include?  Should we also
include the tenshi and keychain man pages since they're predominantly
Gentoo projects?  Oh, what about the various *-config programs' man
pages?

-g2boojum-
-- 
Grant Goodyear	
Gentoo Developer
g2boojum@gentoo.org
http://www.gentoo.org/~g2boojum
GPG Fingerprint: D706 9802 1663 DEF5 81B0  9573 A6DC 7152 E0F6 5B76

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]