From owner-freebsd-doc Wed Jun 12 10:50:54 2002 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (pc-62-31-42-140-hy.blueyonder.co.uk [62.31.42.140]) by hub.freebsd.org (Postfix) with ESMTP id 9039837B409; Wed, 12 Jun 2002 10:50:48 -0700 (PDT) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id g5C7r8I11357; Wed, 12 Jun 2002 08:53:08 +0100 (BST) (envelope-from nik) Date: Wed, 12 Jun 2002 08:53:07 +0100 From: Nik Clayton To: Ross Lippert Cc: nik@FreeBSD.ORG, doc@FreeBSD.ORG Subject: Re: Per-release installation instructions? Message-ID: <20020612085307.B39690@canyon.nothing-going-on.org> References: <20020611210023.A39690@canyon.nothing-going-on.org> <200206112109.OAA20191@eskimo.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="I/+EtO164iqGPpU0" Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <200206112109.OAA20191@eskimo.com>; from ripper@eskimo.com on Tue, Jun 11, 2002 at 02:09:04PM -0700 Organization: FreeBSD Project 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 --I/+EtO164iqGPpU0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Jun 11, 2002 at 02:09:04PM -0700, Ross Lippert wrote: > OR are you saying that by linking to the online installation notes > that information post-4.5 was being mixed in with information current > with 4.5? Was this because one was the online handbook and it should > have been following a local link? Yes. Right now, go to the website. Look at the top right where it says "Current Release: 4.5" (assuming 4.6 hasn't been released by the time you read this. The second link there is "Installation Guide" which goes to chapter 2 of the Handbook on the web site. The problem is that the handbook is now talking about 4-stable through to 4.6. There's information in the install guide that's correct for 4-stable, but that is incorrect for 4.5. For example, the version of X that's installed. There may be others. We could work around this in the text: ... If you're installing FreeBSD 4.5 or lower then the X version installed is 3.X. If you're installing FreeBSD 4.6 or above then the X version installed is 4.X. which is OK as far as it goes, but doesn't scale very well, and distracts from the flow of the text. Maybe repo copy chapter 2 to somewhere under the web tree at release time and build it as a smaller book. We could do the same thing without a repo copy because the Handbook's tagged with the release info, so the web site build infrastructure could just check out a copy of the chapter and its images with the correct tag. Anyone feel like giving this a go? N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ (__) FreeBSD Documentation Project http://www.freebsd.org/docproj/ \\\'',) \/ \= ^ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- .\._/= _) --I/+EtO164iqGPpU0 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.7 (FreeBSD) iD8DBQE9Bv3ik6gHZCw343URAhRoAJ0Xf2qUcCcCMVDvipAxBb2cXV91pwCeLAE5 1jPxiQ0C9TLIaa4rxnKMxqw= =5ncj -----END PGP SIGNATURE----- --I/+EtO164iqGPpU0-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message