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

[Mark Miller <mirell@gmail.com>]

The issue with using man2html is the fact that apparently a lot of the
man pages are ill-formated, from what I've seen. And another benefit
with the DocBook format is the ability to properly form indices, with
greater ease.

On Mon, 29 Nov 2004 14:48:57 -0600, Grant Goodyear <g2boojum@gentoo.org> wrote
> 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
> 
> 
> 


-- 
Mark A. Miller
mark@mirell.org
(US) +1 512-796-3592

--
gentoo-dev@gentoo.org mailing list