From owner-svn-doc-head@FreeBSD.ORG Tue Oct 2 16:51:47 2012 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 08BDD1065672; Tue, 2 Oct 2012 16:51:47 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id E5E978FC16; Tue, 2 Oct 2012 16:51:46 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q92Gpksk071057; Tue, 2 Oct 2012 16:51:46 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q92GpkBu071055; Tue, 2 Oct 2012 16:51:46 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201210021651.q92GpkBu071055@svn.freebsd.org> From: Warren Block Date: Tue, 2 Oct 2012 16:51:46 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r39639 - head/en_US.ISO8859-1/books/handbook/ports X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 02 Oct 2012 16:51:47 -0000 Author: wblock Date: Tue Oct 2 16:51:46 2012 New Revision: 39639 URL: http://svn.freebsd.org/changeset/doc/39639 Log: Update ports chapter to reflect CVSup deprecation, add svn information. PR: docs/172210 Submitted by: Beat Gaetzi Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Tue Oct 2 14:00:52 2012 (r39638) +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Tue Oct 2 16:51:46 2012 (r39639) @@ -616,24 +616,135 @@ docbook = 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 (that is, maintaining additional local + patches) will probably prefer to use Subversion directly. The + CVSup service is being phased out + as of February 28, 2013, and further use is + discouraged. + + Obtaining the Ports Collection - Before you can install ports, you must first obtain the - Ports Collection—which is essentially a set of + The Ports Collection is a set of Makefiles, patches, and description files - placed in /usr/ports. - + stored in /usr/ports. This set of files + is used for building and installing applications &os;. The + instructions below show several methods of obtaining the Ports + Collection if it was not installed during initial &os; + setup. + + + Portsnap Method + + Portsnap is a fast and + user-friendly tool for retrieving the Ports Collection, the + preferred choice for most users. See + Using + Portsnap for a detailed description of + Portsnap. + + + Download a compressed snapshot of the Ports Collection + into /var/db/portsnap. + + &prompt.root; portsnap fetch + + + + When running Portsnap + for the first time, extract the snapshot into + /usr/ports: + + &prompt.root; portsnap extract + + After the first use of + Portsnap has been completed as + shown above, + /usr/ports can be + updated with: - When installing your FreeBSD system, - sysinstall asked if you would like - to install the Ports Collection. If you chose no, you can - follow these instructions to obtain the ports - collection: + &prompt.root; portsnap update + + + + + Subversion Method + + If more control over the ports tree is needed (for + example, for maintaining local changes) + Subversion can be used to + obtain the Ports Collection. Refer to the + Subversion Primer for a detailed description of + Subversion. + + + Subversion must be + installed before it can be used to check out the ports + tree. If a copy of the ports tree is already present, + install Subversion like + this: + + &prompt.root; cd /usr/ports/devel/subversion +&prompt.root; make install clean + + If the ports tree is not available, + Subversion can be installed as + a package: + + &prompt.root; pkg_add -r subversion + + If pkgng is being used to + manage packages, Subversion can + be installed with it instead: + + &prompt.root; pkg install subversion + + + + Check out a copy of the ports tree. Use a specific + Subversion + mirror close to your geographic location instead + of svn.FreeBSD.org in the + command below for better performance. Committers should + read the Subversion + Primer first to be sure the correct protocol is + chosen. + + &prompt.root; svn checkout svn://svn.FreeBSD.org/ports/head /usr/ports + + + + To update + /usr/ports after + the initial Subversion + checkout: + + &prompt.root; svn update /usr/ports + + 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 +821,6 @@ docbook = - 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