Date: Mon, 30 Oct 2000 09:50:50 -0800 From: "Bruce A. Mah" <bmah@FreeBSD.ORG> To: Jun Kuriyama <kuriyama@imgsrc.co.jp> Cc: freebsd-doc@FreeBSD.ORG Subject: Re: HARDWARE.TXT and RELNOTES.TXT Message-ID: <200010301750.e9UHooc25480@bmah-freebsd-0.cisco.com> 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>
next in thread | previous in thread | raw e-mail | index | archive | help
--==_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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200010301750.e9UHooc25480>