From owner-freebsd-doc@FreeBSD.ORG Sat Oct 15 13:32:23 2005 Return-Path: X-Original-To: doc@FreeBSD.org Delivered-To: freebsd-doc@FreeBSD.ORG Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 79A3916A41F; Sat, 15 Oct 2005 13:32:23 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: from zaphod.nitro.dk (cpe.atm2-0-71337.0x535ccf26.taanxx2.customer.tele.dk [83.92.207.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id A2A7443D5C; Sat, 15 Oct 2005 13:32:22 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 80E87118AC; Sat, 15 Oct 2005 15:32:21 +0200 (CEST) Date: Sat, 15 Oct 2005 15:32:21 +0200 From: "Simon L. Nielsen" To: Ceri Davies , Tom Rhodes , Joel Dahl , doc@FreeBSD.org Message-ID: <20051015133220.GB885@zaphod.nitro.dk> References: <200510142331.j9ENV8nA099971@freefall.freebsd.org> <1129364021.653.11.camel@dude.automatvapen.se> <20051015055837.2a3b9035.trhodes@FreeBSD.org> <20051015122036.GT99170@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="pvezYHf7grwyp3Bc" Content-Disposition: inline In-Reply-To: <20051015122036.GT99170@submonkey.net> User-Agent: Mutt/1.5.10i Cc: Subject: Re: docs/87445: comments for improvement of handbook/kernelconfig-config.html X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 15 Oct 2005 13:32:23 -0000 --pvezYHf7grwyp3Bc Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2005.10.15 13:20:37 +0100, Ceri Davies wrote: > On Sat, Oct 15, 2005 at 05:58:37AM -0400, Tom Rhodes wrote: >=20 > > Or perhaps > > 4.X will be knifed from the handbook. And most likely, the > > only people who will expect it coming will be those that aren't > > going to stand in my way.[1] :) > >=20 > > [1]: Please don't take that as if it's rude, I'm actually > > joking around with it. Cause I know that if someone > > tried that, well, to core && doceng they'd be explaining. >=20 > Actually that's a great idea. There's no reason why we couldn't, like > today, commit a copy of the current handbook to handbook4 and then get > rid of all the crud from the real handbook. Same deal with the FAQ. > The information is still available then, but we no longer have to tear > our own hair own trying to maintain the documents. Wouldn't it be better to create a branch and do appropriate magic in the web build to handle it? We already have magic that handles building the release notes from different branches. While I generally don't care much about repo bloat, starting a trend with making a copy of the Handbook for each FreeBSD major version seems a bit wasteful to me, especially since CVS actually does have a concept for handling situations like this. Especially since I don't expect to see many commits to the 4.X Handbook. This would also make it simpler to do make merges back to the 4.X handbook if/when needed. If people prefer the "copy way" I won't stand in the way, it just doesn't seem like the best solution from my point of view. Just for reference: [simon@eddie:~] du -shc /home/ncvs/doc/en_US.ISO8859-1/books/handbook 19M /home/ncvs/doc/en_US.ISO8859-1/books/handbook --=20 Simon L. Nielsen --pvezYHf7grwyp3Bc Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (FreeBSD) iD8DBQFDUQTkh9pcDSc1mlERAr5rAJ97EwEiQvWMMN/tJepTS51N6kPqwgCfR9X0 Wf/xBbE0MlyrCimnxB5vTIg= =fQvV -----END PGP SIGNATURE----- --pvezYHf7grwyp3Bc--