From owner-freebsd-doc@FreeBSD.ORG Thu Aug 14 03:45:57 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0F67037B404; Thu, 14 Aug 2003 03:45:57 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id D9DE643F3F; Thu, 14 Aug 2003 03:45:54 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.20) id 19nFc9-000CWH-13; Thu, 14 Aug 2003 11:45:53 +0100 Date: Thu, 14 Aug 2003 11:45:52 +0100 From: Ceri Davies To: Greg 'groggy' Lehey Message-ID: <20030814104552.GK39980@submonkey.net> Mail-Followup-To: Ceri Davies , Greg 'groggy' Lehey , Tom Rhodes , freebsd-doc@FreeBSD.org, "Simon L. Nielsen" 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> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="mI5TpPl/qDRoXxBg" Content-Disposition: inline In-Reply-To: <20030814094736.GD10912@wantadilla.lemis.com> User-Agent: Mutt/1.5.4i Sender: Ceri Davies cc: Tom Rhodes cc: freebsd-doc@FreeBSD.org cc: "Simon L. Nielsen" Subject: Re: docs/55122: Handbook should mention that gdbe can't be used with vinum volumes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 14 Aug 2003 10:45:57 -0000 --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" 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--