From owner-freebsd-doc@FreeBSD.ORG Mon Oct 17 06:23:13 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 ABD4616A41F; Mon, 17 Oct 2005 06:23:13 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from pittgoth.com (ns1.pittgoth.com [216.38.206.188]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6871C43D53; Mon, 17 Oct 2005 06:23:10 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost (ip68-105-180-11.dc.dc.cox.net [68.105.180.11]) (authenticated bits=0) by pittgoth.com (8.13.4/8.13.4) with ESMTP id j9H6USgj048378 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 17 Oct 2005 02:30:29 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Mon, 17 Oct 2005 02:22:15 -0400 From: Tom Rhodes To: "Simon L. Nielsen" Message-Id: <20051017022215.64b10694.trhodes@FreeBSD.org> In-Reply-To: <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> <20051015133220.GB885@zaphod.nitro.dk> X-Mailer: Sylpheed version 1.0.5 (GTK+ 1.2.10; i386-portbld-freebsd7.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: doc@FreeBSD.org, joel@FreeBSD.org 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: Mon, 17 Oct 2005 06:23:13 -0000 On Sat, 15 Oct 2005 15:32:21 +0200 "Simon L. Nielsen" wrote: > On 2005.10.15 13:20:37 +0100, Ceri Davies wrote: > > > On Sat, Oct 15, 2005 at 05:58:37AM -0400, Tom Rhodes wrote: > > > > > 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] :) > > > > > > [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. > > > > 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 I could have the glue together and example chapter for building version based handbooks later on this week. It may not be the answer, but it's one solution to an ongoing problem. -- Tom Rhodes