Date: Fri, 05 Jan 2001 11:50:00 -0800 From: bmah@freebsd.org (Bruce A. Mah) To: freebsd-doc@freebsd.org, wilko@freebsd.org Cc: bmah@freebsd.org Subject: RELNOTESng update Message-ID: <200101051950.f05Jo0H24919@bmah-freebsd-0.cisco.com>
next in thread | raw e-mail | index | archive | help
--==_Exmh_81954488P Content-Type: text/plain; charset=us-ascii Hi folks-- I've updated my on-going work on what I hope will be the next-generation release notes. You can see what I've got (these are the release notes for 5.0-CURRENT) at: http://people.freebsd.org/~bmah/relnotes/ I've got a tarball of my working directory, plus the PDF, HTML, and TXT output for the i386 and alpha architectures (plus a placeholder for the ia64 to catch some bugs). I'll try to keep this in sync with the "real" RELNOTES.TXT files. To summarize the features: 1. Conditional text so we can support multiple architectures from one set of source files (no more editing {i386,alpha}/RELNOTES.TXT). 2. The Supported Hardware lists from HARDWARE.TXT and RELNOTES.TXT have been combined. 3. DocBook markup, so we can generate release notes in multiple formats. At this point I would like to get some input from people. In particular: 1. First and foremost, is the concept a Good Thing(TM)? I'm pretty convinced we need something like this (particularly to deal with multiple architectures and information listed in various places). But if the consensus is "no", I want to bail out now. 2. Since I only use i386 architecture machines, I want to make sure we can cover the alpha (and later the ia64, sparc, ppc, or whatever else turns up). So I'd like some alpha folks to look their version over. One question I'd like to get answered: The alpha has its own HARDWARE.TXT file listing different processor/motherboard notes. I'd like to know people's thoughts about folding this in as well (particularly from Wilko, since he's maintaining it). 3. At some point, I'll need to talk to someone who's familiar with "make release" to see about how to integrate this into the build. It'll be similar, but not identical, to how we handle the other docs. One disadvantage is that you won't see a RELNOTES.TXT file (or its equivalent) until a release gets made with documentation-building enabled. Thanks all! Bruce. --==_Exmh_81954488P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.4 (FreeBSD) Comment: Exmh version 2.2 06/23/2000 iD8DBQE6ViVo2MoxcVugUsMRAqeMAKD3Z6ESftVkWOFGXkjgjstSIYUb+ACfco5U Hgjp5pP7HXvrxHnB40wkTvs= =Exfz -----END PGP SIGNATURE----- --==_Exmh_81954488P-- 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?200101051950.f05Jo0H24919>