diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.xml b/en_US.ISO8859-1/books/handbook/ports/chapter.xml
index 05fe018a4b..b32c7bc8c5 100644
--- a/en_US.ISO8859-1/books/handbook/ports/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/ports/chapter.xml
@@ -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.
- 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:
+
+ 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:
+
+ &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
@@ -709,40 +820,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