<warning>

      <para>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.</para></warning>

	<title>Portsnap Method</title>

	<para><application>Portsnap</application> is a fast and user-friendly

	  system for distributing the Ports Collection.

	  Please refer to <link linkend="updating-upgrading-portsnap">Using Portsnap</link>

	  for a detailed description of all <application>Portsnap</application>

	  features.</para>

	<step>

	  <para>Download a compressed snapshot of the Ports Collection into

	    <filename class="directory">/var/db/portsnap</filename>.  You can

	    disconnect from the Internet after this step, if you wish.</para>

	  <screen>&prompt.root; <userinput>portsnap fetch</userinput></screen>

	</step>

	<step>

	  <para>If you are running <application>Portsnap</application> for the

	    first time, extract the snapshot into <filename

	    class="directory">/usr/ports</filename>:

	  </para>

	  <screen>&prompt.root; <userinput>portsnap extract</userinput></screen>

	  <para>If you already have a populated <filename

	    class="directory">/usr/ports</filename> and you are just updating,

	    run the following command instead:</para>

	  <screen>&prompt.root; <userinput>portsnap update</userinput></screen>

	</step>

      </procedure>

      <procedure>

	<title>Subversion Method</title>

	<para>If more control over the ports tree is needed (e.g maintaining 

	  local changes) <application>Subversion</application> can be used for

	  obtaining the Ports Collection. Please refer to <ulink

	  url="&url.articles.committers-guide;/subversion-primer.html">the

	  Subversion Primer</ulink> for a detailed description of all 

	  <application>Subversion</application> features.</para>

	<step>

	  <para>To check out the ports tree with <application>Subversion

	  </application> it needs to be installed first. If you already have

	  a copy of the ports tree install <application>Subversion

	  </application>like this:</para>

	  <screen>&prompt.root; <userinput>cd /usr/ports/devel/subversion

	  </userinput>

&prompt.root; <userinput>make install clean</userinput></screen>

	  <para>If no ports tree is available <application>Subversion

	  </application> can be installed via packages:</para>

	  <screen>&prompt.root; <userinput>pkg_add -r subversion</userinput>

	  </screen>

	  <para>If <application>pkgng</application> is used for packages 

	  <application>Subversion</application> can be installed using

	  pkgng:</para>

	  <screen>&prompt.root; <userinput>pkg install subversion

	  </userinput></screen>

	</step>

	<step>

	  <para>Check out an initial copy of the ports tree. Using one of

	  the provided <ulink

	  url="&url.books.handbook;/mirrors-svn.html">Subversion

	  mirrors</ulink> instead of svn.FreeBSD.org is prefered.

	  Committers should read <ulink

	  url="&url.articles.committers-guide;/subversion-primer.html">the

	  Subversion Primer</ulink> prior to checkout as they might have

	  to check out the ports tree using a different protocol.

	  </para>

	  <screen>&prompt.root; <userinput>svn checkout svn://<replaceable>svn.FreeBSD.org</replaceable>/ports/head /usr/ports</userinput>

	  </screen>

	</step>

	<step>

	  <para>If you already have a checked out <filename

	  class="directory">/usr/ports</filename> and you are just updating,

	  run the following command instead:</para>

	  <screen>&prompt.root; <userinput>cd /usr/ports</userinput>

&prompt.root; <userinput>svn update</userinput></screen>

	</step>

      </procedure>

      <procedure>

	<warning><para>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.</para></warning>