From owner-freebsd-doc Fri Oct 27 6:11: 9 2000 Delivered-To: freebsd-doc@freebsd.org Received: from waterblue.imgsrc.co.jp (waterblue.imgsrc.co.jp [210.226.20.160]) by hub.freebsd.org (Postfix) with ESMTP id 4F26F37B6D8 for ; Fri, 27 Oct 2000 06:10:57 -0700 (PDT) Received: from waterblue.imgsrc.co.jp (localhost [127.0.0.1]) by waterblue.imgsrc.co.jp (8.11.0/8.11.0) with ESMTP id e9RDAoY80483 for ; Fri, 27 Oct 2000 22:10:50 +0900 (JST) Date: Fri, 27 Oct 2000 22:10:50 +0900 Message-ID: <7md7gmig4l.wl@waterblue.imgsrc.co.jp> From: Jun Kuriyama To: freebsd-doc@freebsd.org Subject: Re: HARDWARE.TXT and RELNOTES.TXT In-Reply-To: In your message of "Fri, 27 Oct 2000 11:58:55 +0100" <20001027115855.B1773@canyon.nothing-going-on.org> References: <200010261915.e9QJFep73565@bmah-freebsd-0.cisco.com> <20001026225223.A14836@canyon.nothing-going-on.org> <7mn1fqiv06.wl@waterblue.imgsrc.co.jp> <20001027115855.B1773@canyon.nothing-going-on.org> User-Agent: Wanderlust/1.1.1 (Purple Rain) SEMI/1.13.7 (Awazu) FLIM/1.13.2 (Kasanui) MULE XEmacs/21.1 (patch 12) (Channel Islands) (i386--freebsd) MIME-Version: 1.0 (generated by SEMI 1.13.7 - "Awazu") Content-Type: text/plain; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org At 27 Oct 2000 11:14:51 GMT, nik wrote: > What, specifically, do you think makes DocBook unsuitable? Yes, it's a > bit on the large side, but if someone's building a release they should > already have most of the tools necessary. We're probably only going to > end up using 15-20 DocBook elements in the release notes, but anyone editing > the release notes should be able to see from the rest of the file what > markup to use. I think DocBook is not suitable if we treat source file of RELNOTES.TXT as data. If so, SGML data file should have appropriate structure for that data's structure. But if we treat source file of RELNOTES.TXT as document, DocBook is fine. Having SGML structured data is ideal (really? :-), but it seems too far to achieve. So treating them as documents and using DocBook will be good start. -- Jun Kuriyama // IMG SRC, Inc. // FreeBSD Project To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message