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

[Mark Miller <mirell@gmail.com>]

HTML wasn't the main thing that was the issue. Converting the man
pages from the ancient realm of troff into DocBook would actually be
the main issue.

With a properly formatted DocBook format, you can get your HTML,
XHTML, even PDF if you so desire.

The man page system is an ancient rendition of how to nicely set up a
book in directories, with the different directories different chapters
in your book when you printed it out, done, in, a typesetting
language, troff.

I don't know about you, but I surely would not print out _all_ of my
man pages to put into a binder.

This system needs a major overhaul. That's why I was helping Eric test
the 8,000 some odd line Python script he's written to be able to
automatically convert the troff/etc into DocBook XML format.


On Mon, 29 Nov 2004 22:20:09 +0100, Carsten Lohrke <carlo@gentoo.org> wrote:
> On Monday 29 November 2004 08:36, 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.
> 
> Use Konqueror and type "man:foo" in the address edit field and you'll get your
> html man page.
> 
> 
> Carsten
> 
> 
> 

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

--
gentoo-dev@gentoo.org mailing list