Date: Mon, 17 Oct 2005 02:22:15 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: "Simon L. Nielsen" <simon@FreeBSD.org> Cc: doc@FreeBSD.org, joel@FreeBSD.org Subject: Re: docs/87445: comments for improvement of handbook/kernelconfig-config.html 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>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, 15 Oct 2005 15:32:21 +0200 "Simon L. Nielsen" <simon@FreeBSD.org> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20051017022215.64b10694.trhodes>