From owner-freebsd-hackers Sun Jul 21 18:55:57 2002 Delivered-To: freebsd-hackers@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C122537B400; Sun, 21 Jul 2002 18:55:51 -0700 (PDT) Received: from holly.calldei.com (adsl-208-191-149-232.dsl.hstntx.swbell.net [208.191.149.232]) by mx1.FreeBSD.org (Postfix) with ESMTP id 475C643E6D; Sun, 21 Jul 2002 18:55:51 -0700 (PDT) (envelope-from chris@holly.dyndns.org) Received: by holly.calldei.com (Postfix, from userid 1001) id 37B75ACA; Sun, 21 Jul 2002 20:56:19 -0500 (CDT) Date: Sun, 21 Jul 2002 20:56:19 -0500 From: Chris Costello To: Greg 'groggy' Lehey Cc: developers@FreeBSD.org, hackers@FreeBSD.org Subject: Re: troff vs. DocBook (was: Request for submissions: FreeBSD Bi-Monthly Development Status Report (fwd)) Message-ID: <20020722015619.GB15170@holly.calldei.com> Reply-To: chris@FreeBSD.org References: <20020721141108.GA30472@luke.immure.com> <82745.1027266137@critter.freebsd.dk> <20020722002823.GB69834@wantadilla.lemis.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20020722002823.GB69834@wantadilla.lemis.com> User-Agent: Mutt/1.4i Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG [Cc: list massively trimmed.] On Monday, July 22, 2002, Greg 'groggy' Lehey wrote: > IMO the tags aren't the problem with DocBook. It's just *really* > difficult to get good-looking results with. I've actually converted > the FreeBSD book into DocBook (anybody want a perl script?), but jade > can't format it, and gmat is a real kludge. Theoretically, DocBook is > better, but I want something that works. Well, getting something that looks good out of DocBook is a trivial exercise for somebody who knows how to handle the formatting-related bits (i.e. the *.dsl stylesheets). Comparing ms(7) and DocBook is sort of like comparing apples and oranges. Basically when you're writing a DocBook document, you're simply marking up the information--telling DocBook what's what in terms of paragraphs, lists, host names, the like. ms(7) macros allow you to do a lot of the formatting on your own. I imagine that ORA is moving/has moved away from it for that reason: they want their books to look exactly alike, which is easily accomplished by having authors submit works in DocBook and applying their own `custom' stylesheet. -- +-------------------+-----------------------------------+ | Chris Costello | Diagnostics are the programs that | | chris@FreeBSD.org | run when nothing else will. | +-------------------+-----------------------------------+ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message