| 1 |
HTML wasn't the main thing that was the issue. Converting the man |
| 2 |
pages from the ancient realm of troff into DocBook would actually be |
| 3 |
the main issue. |
| 4 |
|
| 5 |
With a properly formatted DocBook format, you can get your HTML, |
| 6 |
XHTML, even PDF if you so desire. |
| 7 |
|
| 8 |
The man page system is an ancient rendition of how to nicely set up a |
| 9 |
book in directories, with the different directories different chapters |
| 10 |
in your book when you printed it out, done, in, a typesetting |
| 11 |
language, troff. |
| 12 |
|
| 13 |
I don't know about you, but I surely would not print out _all_ of my |
| 14 |
man pages to put into a binder. |
| 15 |
|
| 16 |
This system needs a major overhaul. That's why I was helping Eric test |
| 17 |
the 8,000 some odd line Python script he's written to be able to |
| 18 |
automatically convert the troff/etc into DocBook XML format. |
| 19 |
|
| 20 |
|
| 21 |
On Mon, 29 Nov 2004 22:20:09 +0100, Carsten Lohrke <carlo@g.o> wrote: |
| 22 |
> On Monday 29 November 2004 08:36, Mark Miller wrote: |
| 23 |
> > I was wondering if the Gentoo Development team would be interested in |
| 24 |
> > a Python script that would automatically convert all the troff and all |
| 25 |
> > the other formats of man pages into a DocBook format, which HTML can |
| 26 |
> > easily be generated out of, and incorporate this into the Gentoo |
| 27 |
> > system. |
| 28 |
> |
| 29 |
> Use Konqueror and type "man:foo" in the address edit field and you'll get your |
| 30 |
> html man page. |
| 31 |
> |
| 32 |
> |
| 33 |
> Carsten |
| 34 |
> |
| 35 |
> |
| 36 |
> |
| 37 |
|
| 38 |
-- |
| 39 |
Mark A. Miller |
| 40 |
mark@××××××.org |
| 41 |
(US) +1 512-796-3592 |
| 42 |
|
| 43 |
-- |
| 44 |
gentoo-dev@g.o mailing list |
Archives