From owner-freebsd-doc Fri Aug 31 9:29:38 2001 Delivered-To: freebsd-doc@freebsd.org Received: from femail47.sdc1.sfba.home.com (femail47.sdc1.sfba.home.com [24.254.60.41]) by hub.freebsd.org (Postfix) with ESMTP id 0F41837B406; Fri, 31 Aug 2001 09:29:34 -0700 (PDT) Received: from intruder.bmah.org ([24.176.204.87]) by femail47.sdc1.sfba.home.com (InterMail vM.4.01.03.20 201-229-121-120-20010223) with ESMTP id <20010831162933.XHGG20210.femail47.sdc1.sfba.home.com@intruder.bmah.org>; Fri, 31 Aug 2001 09:29:33 -0700 Received: (from bmah@localhost) by intruder.bmah.org (8.11.5/8.11.3) id f7VGTX370290; Fri, 31 Aug 2001 09:29:33 -0700 (PDT) (envelope-from bmah) Message-Id: <200108311629.f7VGTX370290@intruder.bmah.org> X-Mailer: exmh version 2.5 07/13/2001 with nmh-1.0.4 To: Dima Dorfman Cc: Michael Lucas , freebsd-doc@FreeBSD.ORG, bmah@FreeBSD.ORG Subject: Re: docs/30202: pointer to pointer to information In-Reply-To: <20010831155933.24BD23E28@bazooka.unixfreak.org> References: <20010831155933.24BD23E28@bazooka.unixfreak.org> Comments: In-reply-to Dima Dorfman message dated "Fri, 31 Aug 2001 08:59:28 -0700." From: bmah@FreeBSD.ORG (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_145952744P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Fri, 31 Aug 2001 09:29:32 -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --==_Exmh_145952744P Content-Type: text/plain; charset=us-ascii If memory serves me right, Dima Dorfman wrote: > Michael Lucas wrote: > > My concern was that I wanted it to remain good for "whatever version > > we're on". > > > > Perhaps an entity for "current release release notes" would be nice. > > (Or perhaps I'm just ignorant of the one that exists.) > > The release notes are now kept as SGML files, and the rendered > versions will soon be available on the web site. This resolves this > problem quite nicely, since we can just point people at the latest > -stable release notes (those running -current should be smart enough > to figure out how to get to the right place by themselves). However, > it introduces the problem of what architecture the link should be made > to. Bruce, any ideas? Unfortunately we can't magically determine from within a document what version of FreeBSD the reader is running, or what architecture they're running on. :-) I personally liked the place where Michael pointed to, because we punt this decision off to the reader (I sure hope they can navigate around releases/ to figure out what version and architecture they're running or else they're going to have bigger problems!). But I'd change the text to read something like this (sorry for not doing a diff here): See the complete list in the Hardware Notes for the version of FreeBSD being installed. The Hardware Notes for all released versions of FreeBSD can be found on the FreeBSD Release Information page. FWIW I think any of the three proposals (Michael's, Dima's, or mine) is better than what we're doing right now, which I guess was Michael's original point. Cheers, Bruce. PS. Dima, I'm thinking about how we should put the rendered versions of -RELEASE release notes on the Web site...in theory we could rebuild those the same way you have planned for 4-STABLE and CURRENT, just with different tags, although I was wondering if it might be worth the time/ space tradeoff to dump rendered versions into the www/ CVS repository. But that's a different issue altogether. --==_Exmh_145952744P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: Exmh version 2.3.1+ 05/14/2001 iD8DBQE7j7ts2MoxcVugUsMRAnKMAKCZODXl5y3xm1HOfcxtkCMZyz21UwCfb2KN YaTHJfLPb0c+QREAAvjlFqc= =Ed3R -----END PGP SIGNATURE----- --==_Exmh_145952744P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message