docs/55122: Handbook should mention that gdbe can't be used with vinum volumes

[Ceri Davies]

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 at 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 wrote:
> >>>>>> Synopsis: Handbook should mention that gdbe can't be used with vinum 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 -STABLE.
> >>>>> 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 like
> >>>> gbde.
> >>>
> >>> Greg has a valid point; however, because it could 'just not be complete'.
> >>>
> >>> A simple note "As of this writing, gdbe cannot work with Vinum volumes."
> >>> 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 sections
> > in manpages.
> 
> 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 handbook,
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 argument
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 patches
ready for when re@ sort the branches out, and then commit them all overnight?
It can't be done.

> > When it does work, I'm sure that we'll notice.
> 
> 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
-- 
User: DO YOU ACCEPT JESUS CHRIST AS YOUR PERSONAL LORD AND SAVIOR?
Iniaes: Sure, I can accept all forms of payment.
                                           -- www.chatterboxchallenge.com
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20030814/95485f6b/attachment.sig>