From owner-freebsd-doc@FreeBSD.ORG Mon Oct 1 14:20:02 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 65B8A1065674 for ; Mon, 1 Oct 2012 14:20:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 385D98FC0C for ; Mon, 1 Oct 2012 14:20:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q91EK2L3005805 for ; Mon, 1 Oct 2012 14:20:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q91EK2FI005804; Mon, 1 Oct 2012 14:20:02 GMT (envelope-from gnats) Resent-Date: Mon, 1 Oct 2012 14:20:02 GMT Resent-Message-Id: <201210011420.q91EK2FI005804@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Beat Gätzi Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 167B6106564A for ; Mon, 1 Oct 2012 14:18:02 +0000 (UTC) (envelope-from beat@tinderbox.chruetertee.ch) Received: from tinderbox.chruetertee.ch (cl-104.gva-01.ch.sixxs.net [IPv6:2a02:2528:ff00:67::2]) by mx1.freebsd.org (Postfix) with ESMTP id 73BBD8FC15 for ; Mon, 1 Oct 2012 14:18:01 +0000 (UTC) Received: from tinderbox.chruetertee.ch (localhost [127.0.0.1]) by tinderbox.chruetertee.ch (8.14.5/8.14.5) with ESMTP id q91EHxtv036711 for ; Mon, 1 Oct 2012 16:17:59 +0200 (CEST) (envelope-from beat@tinderbox.chruetertee.ch) Received: (from beat@localhost) by tinderbox.chruetertee.ch (8.14.5/8.14.5/Submit) id q91EHsAB036685; Mon, 1 Oct 2012 16:17:54 +0200 (CEST) (envelope-from beat) Message-Id: <201210011417.q91EHsAB036685@tinderbox.chruetertee.ch> Date: Mon, 1 Oct 2012 16:17:54 +0200 (CEST) From: Beat Gätzi To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/172210: [handbook] [patch] Update ports chapter to reflect CVSup deprecation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Beat Gätzi List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 01 Oct 2012 14:20:02 -0000 >Number: 172210 >Category: docs >Synopsis: [handbook] [patch] Update ports chapter to reflect CVSup deprecation >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Mon Oct 01 14:20:01 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Beat Gätzi >Release: FreeBSD 10.0-CURRENT i386 >Organization: >Environment: System: FreeBSD tinderbox.chruetertee.ch 10.0-CURRENT FreeBSD 10.0-CURRENT #1 r237414M: Fri Jun 22 10:55:48 CEST 2012 root@tinderbox.chruetertee.ch:/usr/obj/usr/home/beat/dev/src/head/sys/BEASTIE i386 >Description: Attached patch changes the default mechanism for fetching the ports tree to portsnap and adds information how to check out the ports tree using Subversion. It also adds a deprecation warning for CVSup. This patch is based on a patch from rwatson@. >How-To-Repeat: >Fix: --- handbook-ports-using-svn.patch begins here --- Index: en_US.ISO8859-1/books/handbook/ports/chapter.xml =================================================================== --- en_US.ISO8859-1/books/handbook/ports/chapter.xml (Revision 39635) +++ en_US.ISO8859-1/books/handbook/ports/chapter.xml (Arbeitskopie) @@ -616,6 +616,15 @@ system. The detailed description of available make targets and environment variables is available in &man.ports.7;. + + As of late 2012, the FreeBSD Ports Project is in the process of + migrating revision control systems from CVS to Subversion. As a + result, these instructions are in a state of change. The preferred + mechanism for general ports use is Portsnap; users requiring local + customization of ports (e.g., additional patches) will prefer to use + Subversion directly. The CVSup service is being phased out as of 28 + February 2013, and its use is discouraged. + Obtaining the Ports Collection @@ -632,8 +641,107 @@ collection: + Portsnap Method + + Portsnap is a fast and user-friendly + system for distributing the Ports Collection. + Please refer to Using Portsnap + for a detailed description of all Portsnap + features. + + + Download a compressed snapshot of the Ports Collection into + /var/db/portsnap. You can + disconnect from the Internet after this step, if you wish. + + &prompt.root; portsnap fetch + + + + If you are running Portsnap for the + first time, extract the snapshot into /usr/ports: + + + &prompt.root; portsnap extract + + If you already have a populated /usr/ports and you are just updating, + run the following command instead: + + &prompt.root; portsnap update + + + + + + Subversion Method + + If more control over the ports tree is needed (e.g maintaining + local changes) Subversion can be used for + obtaining the Ports Collection. Please refer to the + Subversion Primer for a detailed description of all + Subversion features. + + + To check out the ports tree with Subversion + it needs to be installed first. If you already have + a copy of the ports tree install Subversion + like this: + + &prompt.root; cd /usr/ports/devel/subversion + +&prompt.root; make install clean + + If no ports tree is available Subversion + can be installed via packages: + + &prompt.root; pkg_add -r subversion + + + If pkgng is used for packages + Subversion can be installed using + pkgng: + + &prompt.root; pkg install subversion + + + + + Check out an initial copy of the ports tree. Using one of + the provided Subversion + mirrors instead of svn.FreeBSD.org is prefered. + Committers should read the + Subversion Primer prior to checkout as they might have + to check out the ports tree using a different protocol. + + + &prompt.root; svn checkout svn://svn.FreeBSD.org/ports/head /usr/ports + + + + + If you already have a checked out /usr/ports and you are just updating, + run the following command instead: + + &prompt.root; cd /usr/ports +&prompt.root; svn update + + + + + CVSup Method + The CVSup method of retrieving and synchronizing the + ports collection is being deprecated as part of a migration to + Subversion. While it remains supported, the service will be + discontinued as of 28 February 2013. + This is a quick method for getting and keeping your copy of the Ports Collection up to date using CVSup protocol. If you want to learn more about @@ -710,40 +818,6 @@ - Portsnap Method - - Portsnap is an alternative system for - distributing the Ports Collection. - Please refer to Using Portsnap - for a detailed description of all Portsnap - features. - - - Download a compressed snapshot of the Ports Collection into - /var/db/portsnap. You can - disconnect from the Internet after this step, if you wish. - - &prompt.root; portsnap fetch - - - - If you are running Portsnap for the - first time, extract the snapshot into /usr/ports: - - - &prompt.root; portsnap extract - - If you already have a populated /usr/ports and you are just updating, - run the following command instead: - - &prompt.root; portsnap update - - - - - Sysinstall Method This method involves using sysinstall --- handbook-ports-using-svn.patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: