From owner-freebsd-doc Mon Oct 30 9:51: 0 2000 Delivered-To: freebsd-doc@freebsd.org Received: from bmah-freebsd-0.cisco.com (bmah-freebsd-0.cisco.com [171.70.84.42]) by hub.freebsd.org (Postfix) with ESMTP id BFDEC37B4C5 for ; Mon, 30 Oct 2000 09:50:57 -0800 (PST) Received: (from bmah@localhost) by bmah-freebsd-0.cisco.com (8.11.0/8.11.0) id e9UHooc25480; Mon, 30 Oct 2000 09:50:50 -0800 (PST) (envelope-from bmah) Message-Id: <200010301750.e9UHooc25480@bmah-freebsd-0.cisco.com> X-Mailer: exmh version 2.2 06/23/2000 with nmh-1.0.4 To: Jun Kuriyama Cc: freebsd-doc@FreeBSD.ORG Subject: Re: HARDWARE.TXT and RELNOTES.TXT In-Reply-To: <7md7gmig4l.wl@waterblue.imgsrc.co.jp> 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> <7md7gmig4l.wl@waterblue.imgsrc.co.jp> Comments: In-reply-to Jun Kuriyama message dated "Fri, 27 Oct 2000 22:10:50 +0900." From: "Bruce A. Mah" Reply-To: bmah@FreeBSD.ORG X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A 2V%N&+ X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-Url: http://www.employees.org/~bmah/ Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==_Exmh_-1955985666P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Mon, 30 Oct 2000 09:50:50 -0800 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --==_Exmh_-1955985666P Content-Type: text/plain; charset=us-ascii If memory serves me right, Jun Kuriyama wrote: > 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 editin > g > > 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. I don't completely understand what you just wrote here. I *think* you mean to say that if RELNOTES.whatever is to be parsed by other programs as data, then DocBook is not appropriate, but if it's just intended to be a human-readable document, then DocBook is probably OK. I'm thinking that yes, all we really need is a human-readable document. At least that was all that I had intended in my original post. Thanks, Bruce. --==_Exmh_-1955985666P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.4 (FreeBSD) Comment: Exmh version 2.2 06/23/2000 iD8DBQE5/bT62MoxcVugUsMRAq36AJ4xhvfEIsj8eQU12sUErS2qbAXIBgCeIAKl crT9uwP1YBKaWA8wx/o0Xtw= =PFJE -----END PGP SIGNATURE----- --==_Exmh_-1955985666P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message