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

[Greg 'groggy' Lehey]

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.

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

Greg
--
See complete headers for address and phone numbers
-------------- 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/3d5209b0/attachment.sig>