From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 28633 invoked from network); 29 Nov 2004 21:59:57 +0000 Received: from smtp.gentoo.org (156.56.111.197) by lists.gentoo.org with AES256-SHA encrypted SMTP; 29 Nov 2004 21:59:57 +0000 Received: from lists.gentoo.org ([156.56.111.196] helo=parrot.gentoo.org) by smtp.gentoo.org with esmtp (Exim 4.41) id 1CYtYr-0005HE-ON for arch-gentoo-dev@lists.gentoo.org; Mon, 29 Nov 2004 21:59:57 +0000 Received: (qmail 10948 invoked by uid 89); 29 Nov 2004 21:59:57 +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 17493 invoked from network); 29 Nov 2004 21:59:57 +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=c5ZuEWC0/V7zdY/MjyPnUa3zEQBjY2s48BM6+qbj+VxrjCbCW8ouwMXafDvp4I1m5W33+PNn7eF4kes0lBjuwo6jgt/RNftQB7ERuXa/vDCr2o0aDq7w07ZbrfB+hVzFoSBqjdrVMuHoy10iW31K4vkdX1aVT9o13WY/CBWvY8o= Message-ID: <5d3341c0041129135922dbd9fb@mail.gmail.com> Date: Mon, 29 Nov 2004 15:59:41 -0600 From: Mark Miller Reply-To: Mark Miller To: gentoo-dev@lists.gentoo.org In-Reply-To: <200411292220.24955.carlo@gentoo.org> Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit References: <5d3341c004112823364cf77582@mail.gmail.com> <200411292220.24955.carlo@gentoo.org> Subject: Re: [gentoo-dev] man pages - converted to DocBook/HTML X-Archives-Salt: 9de1295d-e2c7-4351-8915-81fef71ce7c3 X-Archives-Hash: fd789bcc67eb55d85aaa991453f884a0 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 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