1 |
The issue with using man2html is the fact that apparently a lot of the |
2 |
man pages are ill-formated, from what I've seen. And another benefit |
3 |
with the DocBook format is the ability to properly form indices, with |
4 |
greater ease. |
5 |
|
6 |
On Mon, 29 Nov 2004 14:48:57 -0600, Grant Goodyear <g2boojum@g.o> wrote |
7 |
> Vapier wrote: [Mon Nov 29 2004, 09:17:20AM CST] |
8 |
> |
9 |
> |
10 |
> > On Monday 29 November 2004 02:36 am, Mark Miller wrote: |
11 |
> > > I was wondering if the Gentoo Development team would be interested in |
12 |
> > > a Python script that would automatically convert all the troff and all |
13 |
> > > the other formats of man pages into a DocBook format, which HTML can |
14 |
> > > easily be generated out of, and incorporate this into the Gentoo |
15 |
> > > system. |
16 |
> > |
17 |
> > for what purpose ? to have HTML versions of all manpages that exist ? |
18 |
> > -mike |
19 |
> |
20 |
> I've always been really impressed with the *BSDs online manpage |
21 |
> databases, but those databases make more sense for the monolithic *BSDs |
22 |
> than they do for the quite heterogeneous Linux distros. That said, I do |
23 |
> think that it would be nice if we had the man pages for Gentoo tools |
24 |
> available online. I would suggest using man2html instead of a full |
25 |
> conversion to docbook, however. |
26 |
> |
27 |
> Let's see, that would mean converting the man pages in portage, |
28 |
> certainly, as well as those in gentoolkit and gentoolkit-dev. It looks |
29 |
> like baselayout also includes some man pages, and I believe that I |
30 |
> included man pages for our mailwrapper package. Are there other |
31 |
> Gentoo-specific man pages that we should include? Should we also |
32 |
> include the tenshi and keychain man pages since they're predominantly |
33 |
> Gentoo projects? Oh, what about the various *-config programs' man |
34 |
> pages? |
35 |
> |
36 |
> -g2boojum- |
37 |
> -- |
38 |
> Grant Goodyear |
39 |
> Gentoo Developer |
40 |
> g2boojum@g.o |
41 |
> http://www.gentoo.org/~g2boojum |
42 |
> GPG Fingerprint: D706 9802 1663 DEF5 81B0 9573 A6DC 7152 E0F6 5B76 |
43 |
> |
44 |
> |
45 |
> |
46 |
|
47 |
|
48 |
-- |
49 |
Mark A. Miller |
50 |
mark@××××××.org |
51 |
(US) +1 512-796-3592 |
52 |
|
53 |
-- |
54 |
gentoo-dev@g.o mailing list |