From owner-freebsd-doc@FreeBSD.ORG Sun Jan 27 22:16:03 2013 Return-Path: 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 1B4AE65D; Sun, 27 Jan 2013 22:16:03 +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 B559F917; Sun, 27 Jan 2013 22:16:02 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.6/8.14.6) with ESMTP id r0RMG0Jh010480; Sun, 27 Jan 2013 15:16:00 -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 r0RMG0Ow010477; Sun, 27 Jan 2013 15:16:00 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Sun, 27 Jan 2013 15:16:00 -0700 (MST) From: Warren Block To: "Isaac (.ike) Levy" Subject: Re: removing CVS in Handbook Updating and Upgrading chapter In-Reply-To: <1359319922-4118699.16248077.fr0RKpjZd021871@rs149.luxsci.com> Message-ID: References: <1359241802-3572135.75152325.fr0QN9mrI032137@rs149.luxsci.com> <1359270722-3962523.11114096.fr0R7BNq4003267@rs149.luxsci.com> <20130127072036.GL1423@glenbarber.us> <1359272102-5757022.21162222.fr0R7YAiH011169@rs149.luxsci.com> <1359319922-4118699.16248077.fr0RKpjZd021871@rs149.luxsci.com> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Sun, 27 Jan 2013 15:16:00 -0700 (MST) Cc: Glen Barber , freebsd-doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 27 Jan 2013 22:16:03 -0000 On Sun, 27 Jan 2013, Isaac (.ike) Levy wrote: > Warren, I owe you and Glen a drink for dealing with this exasperating thread. > I wouldn't continue if I didn't believe new users first installs are extremely important, Me either. Although I don't understand why new users would csup -STABLE or -CURRENT on their first installs... > On Jan 27, 2013, at 3:15 PM, Warren Block wrote: >> >> 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. > > I can totally agree, all *CVS* verbiage can be removed from the doc. By CVS, I mean the application itself and the special-case programs that use it, like csup and cvsup. >> My personal feeling is that continuing to suggest CVS for -STABLE or -CURRENT, even with a deprecation warning, is a disservice to those users. > > I can certainly see that point. cusp(1) has a man page, config files, etc? it's pretty self-evident to admins who want to use it. > > -- > However, the one place where people are getting tripped up, is the quick fetch required before buildworld/buildkernel: > > I see nothing but benefit leaving one line before the buildworld/makeworld dance: > # csup /usr/share/examples/standard-supfile But that's not in there now. The sections about updating source are separate from the buildworld section. And the cvsup/csup part is not one line, because it goes into details about editing the supfile. Which must be done before running that single line, because the example doesn't work as-is. > And one more line after that, > "cvsup/csup(1) has been deprecated, and will be end-of-lifed when the replacement is completed in base" Followed by "Do not use this, because it will go away permanently soon. In fact, it was kind of a mistake to mention it at all, because it's just going to cause you trouble. Stop using cvs, cvsup, and csup. They don't care about you, they're just using you. The sooner you quit, the better for everyone. Seriously, it's over, if you use CVS now you'll just have to switch to something else in a little while anyway. Pick something else. You can use svn for development versions or portsnap or tar downloads for releases. Pick anything else, we implore you. Really, stop using CVS now, right now. We implore you, stop using that thing we suggested. If we could take it back, we would. Looking back fills us with sorrow and regret. In fact, we're going to retroactively declare that we never said it, and sent you in the right direction in the first place. We're so sorry. Please forgive us." > It's a lot simpler than leading them down the SVN setup path, the state it's in today! svn has to be installed from ports... but so did cvsup, and it had large dependencies, and people still use it. svn setup is simpler than cvsup or csup--no supfile, it's just URLs. But again, those are arguments against deprecating CVS, not against removing it from the documentation. That head has crashed on the platter, the swallow has dropped the coconut, the anti-increment has impacted the impeller.