From owner-freebsd-doc@FreeBSD.ORG Mon May 19 00:09:23 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E3A8A37B401; Mon, 19 May 2003 00:09:23 -0700 (PDT) Received: from builder.freebsdmall.com (builder.freebsdmall.com [65.86.180.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4F41643F85; Mon, 19 May 2003 00:09:23 -0700 (PDT) (envelope-from murray@builder.freebsdmall.com) Received: (from root@localhost) by builder.freebsdmall.com (8.12.9/8.11.6) id h4J799cu010239; Mon, 19 May 2003 00:09:09 -0700 (PDT) (envelope-from murray) Date: Mon, 19 May 2003 00:09:08 -0700 From: Murray Stokely To: "Greg 'groggy' Lehey" Message-ID: <20030519000908.E8403@freebsdmall.com> References: <20030518.095226.115908955.imp@bsdimp.com> <20030518160039.GA25804@submonkey.net> <20030519013706.GN77354@wantadilla.lemis.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20030519013706.GN77354@wantadilla.lemis.com>; from grog@FreeBSD.org on Mon, May 19, 2003 at 11:07:06AM +0930 X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: doc@FreeBSD.org cc: "M. Warner Losh" Subject: Re: DocBook book X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 07:09:24 -0000 On Mon, May 19, 2003 at 11:07:06AM +0930, Greg 'groggy' Lehey wrote: > I have it, and I can't recommend it. Despite the name, it's a > reference, not a guide. For an example of the kind of book I'm > looking for, see http://www.alltel.net/~kollar/utp/. That's about > troff, not DocBook, but it's a well written book. I don't think > anything similar is available for DocBook. I can recommend DocBook TDG strongly if you are trying to author something in DocBook for the first time. The whole point of SGML is that it is a totally different paradigm from something like troff. Authors aren't supposed to have to worry abou the complications of presentation. This book teaches you the tags that have been defined to describe technical content. It is another problem domain (usually dealt with by a separate person) to write an XML application to query that document for semantic information, process the SGML document and turn it into another output format, process the SGML document and create a audio rendering, etc.. The book you reference has chapters on learning vi, Unix fundamentals, and all kinds of typesetting information, all of which is completely irrellevant in the SGML/XML world. I'm sure it's a great book on troff, but it's not a fair comparison. If Warner would like to know more about the process of rendering DocBook SGML files into different output formats, then the wrong question was asked and a different book would have been recommended. - Murray