From owner-freebsd-doc Thu Jan 25 22:44:50 2001 Delivered-To: freebsd-doc@freebsd.org Received: from wantadilla.lemis.com (wantadilla.lemis.com [192.109.197.80]) by hub.freebsd.org (Postfix) with ESMTP id 8D5AF37B400 for ; Thu, 25 Jan 2001 22:44:32 -0800 (PST) Received: by wantadilla.lemis.com (Postfix, from userid 1004) id 316846A936; Fri, 26 Jan 2001 17:14:30 +1030 (CST) Date: Fri, 26 Jan 2001 17:14:30 +1030 From: Greg Lehey To: FreeBSD Documenters Subject: Finally! O'Reilly's gmat package is usable Message-ID: <20010126171429.B1948@wantadilla.lemis.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-418-838-708 WWW-Home-Page: http://www.lemis.com/~grog X-PGP-Fingerprint: 6B 7B C3 8C 61 CD 54 AF 13 24 52 F8 6D A4 95 EF Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org A month or so back I sent a message describing O'Reilly's gmat package, which is what they use for creating their books. It converts DocBook into troff and then formats it. Until yesterday, it sort of limped, but it wasn't really useful enough to do anything with. Now I have found the bug and fixed it, and I think it's reasonable to say that it produces good quality output. It doesn't understand the FreeBSD extensions to DocBook, of course, but it's possible that it could be done. Documentation is sparse; there's no man page, but one of the patches creates a file /usr/ports/textproc/gmat/work/gmat-0.2.4/gmat.sgm, which describes how to use it. I don't much like the interface: instead of using Makefiles, they have a thing called a BOOKFILE, which is administered with various perl incantations. Actually running the formatter is relatively complicated, but you can get an overview with the 'gmat' command and no arguments. Greg -- Finger grog@lemis.com for PGP public key See complete headers for address and phone numbers To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message