Date: Thu, 14 Aug 2003 11:45:52 +0100 From: Ceri Davies <setantae@submonkey.net> To: Greg 'groggy' Lehey <grog@FreeBSD.org> Cc: "Simon L. Nielsen" <simon@FreeBSD.org> Subject: Re: docs/55122: Handbook should mention that gdbe can't be used with vinum volumes Message-ID: <20030814104552.GK39980@submonkey.net> In-Reply-To: <20030814094736.GD10912@wantadilla.lemis.com> References: <200308122008.h7CK8F9D074923@freefall.freebsd.org> <20030813054823.GP23460@wantadilla.lemis.com> <20030813084125.GA408@FreeBSD.org> <20030813100234.778637ae.trhodes@FreeBSD.org> <20030813233932.GA23460@wantadilla.lemis.com> <20030814091654.GI39980@submonkey.net> <20030814094736.GD10912@wantadilla.lemis.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--mI5TpPl/qDRoXxBg
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
On Thu, Aug 14, 2003 at 07:17:36PM +0930, Greg 'groggy' Lehey wrote:
> On Thursday, 14 August 2003 at 10:16:54 +0100, Ceri Davies wrote:
> > On Thu, Aug 14, 2003 at 09:09:32AM +0930, Greg 'groggy' Lehey wrote:
> >> On Wednesday, 13 August 2003 at 10:02:34 -0400, Tom Rhodes wrote:
> >>> On Wed, 13 Aug 2003 10:41:27 +0200
> >>> "Simon L. Nielsen" <simon@freebsd.org> wrote:
> >>>
> >>>> On 2003.08.13 15:18:23 +0930, Greg 'groggy' Lehey wrote:
> >>>>> On Tuesday, 12 August 2003 at 13:08:15 -0700, Simon L. Nielsen wrot=
e:
> >>>>>> Synopsis: Handbook should mention that gdbe can't be used with vin=
um volumes
> >>>>>>
> >>>>>> Responsible-Changed-From-To: freebsd-doc->simon
> >>>>>> Responsible-Changed-By: simon
> >>>>>> Responsible-Changed-When: Tue Aug 12 13:07:47 PDT 2003
> >>>>>> Responsible-Changed-Why:
> >>>>>> I will handle this one.
> >>>>>
> >>>>> Please close the PR. We don't document -CURRENT; we document -STAB=
LE.
> >>>>> Until things have finished developing, there's no way to know what =
can
> >>>>> be used with what.
> >>>>
> >>>> Actually we document both the latest 5.X and 4.X releases in the
> >>>> handbook, otherwise there would be no mention of 5.X only features l=
ike
> >>>> gbde.
> >>>
> >>> Greg has a valid point; however, because it could 'just not be comple=
te'.
> >>>
> >>> A simple note "As of this writing, gdbe cannot work with Vinum volume=
s."
> >>> I can see how making the note would definatly be documenting for 5.X,
> >>> but it should not be some huge paragraph.
> >>
> >> My concern is that this would require another modification, another
> >> PR. If we did this for every transient incompatibility in -CURRENT,
> >> we wouldn't have time for anything else. It shouldn't be put in the
> >> documentation.
> >
> > As a user trying to get it working, I'd be very happy to see it in the
> > documentation. It *should* be there, just the same as we have BUGS sec=
tions
> > in manpages.
>=20
> No. If you're using -CURRENT, you should be subscribed to
> FreeBSD-CURRENT. It's been discussed there.
Greg, by this argument, the gdbe section should be taken out of the handboo=
k,
and all the work that the doc team have been doing over the last few months
to make sure that we're in some kind of shape to cutover from 4-STABLE to
5-STABLE should go too. I'll remind you that having documentation for gdbe
in the handbook was one of the desired features for 5.0-RELEASE. Your argu=
ment
that -CURRENT shouldn't be documented in the handbook simply doesn't wash. =
Are
we to be expected to suddenly have a bunch of 5.X specific documentation pa=
tches
ready for when re@ sort the branches out, and then commit them all overnigh=
t?
It can't be done.
> > When it does work, I'm sure that we'll notice.
>=20
> No. Once things like this get entrenched, they live for ever. People
> are still talking about the USL/BSD wars of ten years ago.
I disagree. When it does work, we'll notice for one of two reasons, and
cvs ci the note away. I don't see the relevance of USL/BSD at all.
I'm really, desperately, trying not to believe that we are having this
discussion because you wrote vinum, but I'm finding that harder and harder.
Ceri
--=20
User: DO YOU ACCEPT JESUS CHRIST AS YOUR PERSONAL LORD AND SAVIOR?
Iniaes: Sure, I can accept all forms of payment.
-- www.chatterboxchallenge.com
--mI5TpPl/qDRoXxBg
Content-Type: application/pgp-signature
Content-Disposition: inline
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (FreeBSD)
iD8DBQE/O2hgocfcwTS3JF8RAm2lAKCXS3as/hU42wYNSaGdAmFpMd2gvQCdG93P
BznOJ0/FmQ+z0HV8I3hQbw0=
=vlga
-----END PGP SIGNATURE-----
--mI5TpPl/qDRoXxBg--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030814104552.GK39980>