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 |