From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 7003 invoked from network); 29 Nov 2004 21:13:56 +0000 Received: from smtp.gentoo.org (156.56.111.197) by lists.gentoo.org with AES256-SHA encrypted SMTP; 29 Nov 2004 21:13:56 +0000 Received: from lists.gentoo.org ([156.56.111.196] helo=parrot.gentoo.org) by smtp.gentoo.org with esmtp (Exim 4.41) id 1CYsqK-0006rx-46 for arch-gentoo-dev@lists.gentoo.org; Mon, 29 Nov 2004 21:13:56 +0000 Received: (qmail 31173 invoked by uid 89); 29 Nov 2004 21:13:55 +0000 Mailing-List: contact gentoo-dev-help@gentoo.org; run by ezmlm Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@gentoo.org Received: (qmail 25674 invoked from network); 29 Nov 2004 21:13:55 +0000 DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:reply-to:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:references; b=G/r3JyMFuFqKa2oSdYMrya8+zGdxgjc8FY0wchAs3z3lWPyd4Wdi+rugvmiVJN/m0FLFH+1zMAp2TibBL3MI37L4vGnvKeAZ+XnRjxMz425jBny6Tc7QZm/KuGJTwhvgwsEY0x5OZQ//MlK9RD+6qD6GIRxJ0PhgujJCB3fU2NQ= Message-ID: <5d3341c004112913132f4dc523@mail.gmail.com> Date: Mon, 29 Nov 2004 15:13:14 -0600 From: Mark Miller Reply-To: Mark Miller To: gentoo-dev@lists.gentoo.org In-Reply-To: <20041129204857.GA4808@server.grantgoodyear.org> Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit References: <5d3341c004112823364cf77582@mail.gmail.com> <200411291017.20933.vapier@gentoo.org> <20041129204857.GA4808@server.grantgoodyear.org> Subject: Re: [gentoo-dev] man pages - converted to DocBook/HTML X-Archives-Salt: fdfc3a1f-cfe5-4a09-bd8a-e092b97ef117 X-Archives-Hash: ca123cd5be6ddd3b3f8381b2ba4b75ff 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 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