From owner-freebsd-doc@FreeBSD.ORG  Sun Jan 27 20:15:54 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
 by hub.freebsd.org (Postfix) with ESMTP id EBA77E8C;
 Sun, 27 Jan 2013 20:15:54 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 by mx1.freebsd.org (Postfix) with ESMTP id 69F7E31F;
 Sun, 27 Jan 2013 20:15:54 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.6/8.14.6) with ESMTP id r0RKFqKI009955;
 Sun, 27 Jan 2013 13:15:52 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.6/8.14.6/Submit) with ESMTP id r0RKFqP6009952;
 Sun, 27 Jan 2013 13:15:52 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Date: Sun, 27 Jan 2013 13:15:52 -0700 (MST)
From: Warren Block <wblock@wonkity.com>
To: "Isaac (.ike) Levy" <ike@blackskyresearch.net>
Subject: Re: removing CVS in Handbook Updating and Upgrading chapter
In-Reply-To: <1359272102-5757022.21162222.fr0R7YAiH011169@rs149.luxsci.com>
Message-ID: <alpine.BSF.2.00.1301271232560.9759@wonkity.com>
References: <alpine.BSF.2.00.1301241510470.86451@wonkity.com>
 <alpine.GSO.1.10.1301251321400.9389@multics.mit.edu>
 <alpine.BSF.2.00.1301251154450.5025@wonkity.com>
 <1359241802-3572135.75152325.fr0QN9mrI032137@rs149.luxsci.com>
 <alpine.BSF.2.00.1301261808410.2537@wonkity.com>
 <1359270722-3962523.11114096.fr0R7BNq4003267@rs149.luxsci.com>
 <20130127072036.GL1423@glenbarber.us>
 <1359272102-5757022.21162222.fr0R7YAiH011169@rs149.luxsci.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
 (wonkity.com [127.0.0.1]); Sun, 27 Jan 2013 13:15:52 -0700 (MST)
Cc: Glen Barber <gjb@FreeBSD.org>, freebsd-doc@FreeBSD.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 27 Jan 2013 20:15:55 -0000

On Sun, 27 Jan 2013, Isaac (.ike) Levy wrote:

>>> + ports, cvsup access end-of-lifed Feb 28
> - great- drop all ports references to cvs/cvsup
>
>>> - source, cvsup deprecated - no end-of-life date set
> - please do not drop the current canonical base/src fetch method from the handbook!
>
> However, cvsup is still merely deprecated, without a clear canonical replacement, (per notes in my previous email).

Understood, but really that is an argument against deprecating CVS, not 
removing it from the docs.

> Therefore, I hope I'm being clearly understood that it's cleaner for *users* to still fetch *base/src* with cvsup, until:
>
>  - canonical src fetch replacement is in place
>  - whenever cvsup for base/src has an end-of-life date set, (like ports does- Feb. 28!)
>
> At that point, it seems rational that the last references to cvsup can disappear.  (The rest of CVS can disappear before that though?)

Say we leave CVS references in this chapter, and CVS for source goes 
away in (for example) six months.  Anyone who starts using CVS in that 
time will be forced to switch.  And they would be justifiably upset, 
because they were offered an option that was going away.

My personal feeling is that continuing to suggest CVS for -STABLE or 
-CURRENT, even with a deprecation warning, is a disservice to those 
users.

Using CVS is still documented in Appendix A, along with a big 
deprecation warning.