From owner-freebsd-hackers Mon Jul 29 1: 4:34 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 7F8BB37B400; Mon, 29 Jul 2002 01:04:25 -0700 (PDT) Received: from wantadilla.lemis.com (wantadilla.lemis.com [192.109.197.80]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6BF2643E6E; Mon, 29 Jul 2002 01:04:22 -0700 (PDT) (envelope-from grog@lemis.com) Received: by wantadilla.lemis.com (Postfix, from userid 1004) id 33480812FD; Mon, 29 Jul 2002 17:34:18 +0930 (CST) Date: Mon, 29 Jul 2002 17:34:17 +0930 From: Greg 'groggy' Lehey To: Nik Clayton , Murray Stokely Cc: Poul-Henning Kamp , Bob Willcox , Paul Richards , Robert Watson , Terry Lambert , Julian Elischer , developers@FreeBSD.org, hackers@FreeBSD.org, doc@FreeBSD.org Subject: Re: troff vs. DocBook (was: Request for submissions: FreeBSD Bi-Monthly Development Status Report (fwd)) Message-ID: <20020729080417.GD68969@wantadilla.lemis.com> References: <20020721141108.GA30472@luke.immure.com> <82745.1027266137@critter.freebsd.dk> <20020722002823.GB69834@wantadilla.lemis.com> <20020729000024.D7467@freebsdmall.com> <20020721141108.GA30472@luke.immure.com> <82745.1027266137@critter.freebsd.dk> <20020722002823.GB69834@wantadilla.lemis.com> <20020724203156.GB58018@clan.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20020729000024.D7467@freebsdmall.com> <20020724203156.GB58018@clan.nothing-going-on.org> User-Agent: Mutt/1.3.99i Organization: The FreeBSD Project Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-418-838-708 WWW-Home-Page: http://www.FreeBSD.org/ X-PGP-Fingerprint: 9A1B 8202 BCCE B846 F92F 09AC 22E6 F290 507A 4223 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 On Wednesday, 24 July 2002 at 21:31:56 +0100, Nik Clayton wrote: > On Mon, Jul 22, 2002 at 09:58:23AM +0930, Greg 'groggy' Lehey wrote: >> IMO the tags aren't the problem with DocBook. It's just *really* >> difficult to get good-looking results with. > > What did you think of the 2nd edition of the Handbook? That was Docbook > toolchain all the way (with the possible exception of some small > hand-tweaks to the finished postscript by Murray). I've taken a look at the book again. Yes, it's clean. I don't like the small fonts and the excessive leading and other vertical spacing, but I suppose that could be fixed in the style sheets. There are also a number of widows and orphans, for example the top(1) example on page 99/100. I also suspect that massaging the PostScript was to get round some annoyances of using DocBook. On Monday, 29 July 2002 at 0:00:24 -0700, Murray Stokely wrote: > [CC: changed to a more appropriate mailing list, original list BCCed] > > On Mon, Jul 22, 2002 at 09:58:23AM +0930, 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. > > Hey Greg, > > What's the problem with jade? Hmm. Looking back on what I said there, I'm jumping to conclusions. What I meant was that I needed to use gmat because it contains the O'Reilly style sheets. That's not really a jade issue. > I will certainly agree that it is difficult to get good-looking > results with jade, but you should at least be able to format your > document and get a valid PostScript file with Norm's default > stylesheets. Yes, I've been able to do that with gmat. Given that it worked (and a lot faster than jade, too), I didn't try using jade. If I had done, I fear I would have run into some horrendous problems due to my lack of understanding of the maze of configuration files. > Did TeX run out of resources? Did you bump up the memory allocation > in texmf.cnf? I do recall doing this in the past. This isn't really a sound-off about DocBook, just about the relative turgidity of the tools. I've tried reading the DocBook book, and I've found it very confusing. A large part of the problem, though, is simply the fact that I'm happy with troff, and I haven't seen enough advantage in DocBook to migrate to it. Greg -- See complete headers for address and phone numbers To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message