Skip site navigation (1)Skip section navigation (2)
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>

next in thread | previous in thread | raw e-mail | index | archive | help

--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--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20051015133220.GB885>