From owner-freebsd-doc Tue Jan 16 10:46:13 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 1894C37B69C; Tue, 16 Jan 2001 10:45:54 -0800 (PST) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.1/8.11.1) id f0GIOYf07423; Tue, 16 Jan 2001 18:24:34 GMT (envelope-from nik) Date: Tue, 16 Jan 2001 18:24:34 +0000 From: Nik Clayton To: Brooks Davis Cc: Nik Clayton , Martin Horcicka , freebsd-doc@FreeBSD.ORG Subject: Re: man, TOC, xml... Message-ID: <20010116182434.A7327@canyon.nothing-going-on.org> References: <20010116172751.A3414@canyon.nothing-going-on.org> <20010116095547.A13543@Odin.AC.HMC.Edu> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010116095547.A13543@Odin.AC.HMC.Edu>; from brooks@one-eyed-alien.net on Tue, Jan 16, 2001 at 09:55:48AM -0800 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Jan 16, 2001 at 09:55:48AM -0800, Brooks Davis wrote: > On Tue, Jan 16, 2001 at 05:27:51PM +0000, Nik Clayton wrote: > > We would not be the first Unix to adopt DocBook for man pages. Solaris > > does -- Solaris 7 had a mix of DocBook and traditional *roff manual > > pages, and, AIUI, Solaris 8 is all DocBook (or rather, SolBook, Sun's > > custom, cut down version of DocBook). > > > > I would support an effort to get DocBook in to the base system, but I > > don't have the time right now to drive such an effort. I will, however, > > cheerfully sit on the sidelines shouting encouragement and offering > > advice. > > I looked at what Solaris does a while back and they used a script called > sgml2roff for formatting. sgml2roff is derived from docbook-to-man.sh > which you can get under an X11 license at: > > http://www.oasis-open.org/docbook/tools/dtm/ Useful info. Don't suppose you've tried that on FreeBSD have you? > They actually created a parallel man hierarchy for SGML manpages in > /usr/share/man/sman*. This seems like the approch to take if someone > wants to work on this. It looks like the required infrastructure is > nsgmls from Jade or OpenJade and DocBook itself. I suspect that people > will want to modify this stuff to generate mdoc or mdocNG instead of man > macros in the roff output. > > Of course, this thing creates tons of bikeshed issues. For instance, if > someone really was crazy enough to try to fight the battle to move > manpages into the doc tree, doing it during a conversion to SGML would > be the best opportunity that's likely to come along. I don't want to bring man pages under the doc/ hierarchy -- I want to put DocBook (and an XML processor) under the src/ hierarchy. . . N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message