Date: Sat, 15 Oct 2005 15:32:21 +0200 From: "Simon L. Nielsen" <simon@FreeBSD.org> To: Ceri Davies <ceri@submonkey.net>, Tom Rhodes <trhodes@FreeBSD.org>, Joel Dahl <joel@FreeBSD.org>, doc@FreeBSD.org Subject: Re: docs/87445: comments for improvement of handbook/kernelconfig-config.html Message-ID: <20051015133220.GB885@zaphod.nitro.dk> In-Reply-To: <20051015122036.GT99170@submonkey.net> References: <200510142331.j9ENV8nA099971@freefall.freebsd.org> <1129364021.653.11.camel@dude.automatvapen.se> <20051015055837.2a3b9035.trhodes@FreeBSD.org> <20051015122036.GT99170@submonkey.net>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] 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 -- Simon L. Nielsen [-- Attachment #2 --] -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (FreeBSD) iD8DBQFDUQTkh9pcDSc1mlERAr5rAJ97EwEiQvWMMN/tJepTS51N6kPqwgCfR9X0 Wf/xBbE0MlyrCimnxB5vTIg= =fQvV -----END PGP SIGNATURE-----help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20051015133220.GB885>