From b142a93cf767e5e81b5e20ff630f4432a5406b3d Mon Sep 17 00:00:00 2001
From: Chern Lee <chern@FreeBSD.org>
Date: Tue, 23 Oct 2001 19:21:02 +0000
Subject: [PATCH] Add a section on obtaining the ports collection using CVSup
 or Sysinstall.

Suggested by: Dan Langille <dan@langille.org>
---
 .../books/handbook/ports/chapter.sgml         | 115 ++++++++++++++++++
 1 file changed, 115 insertions(+)

diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
index 71edb9c7ef..701446b92a 100644
--- a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
@@ -440,6 +440,121 @@ docbook                     =
       ports collection to install or remove programs from your
       system.</para>
 
+    <sect2 id="ports-tree">
+      <title>Obtaining the Ports Collection</title>
+
+      <para>Before you can install ports, you must first obtain the
+	ports collection&mdash;which is essentially a set of Makefiles,
+	patches, and description files usually placed in
+	<filename>/usr/ports</filename>.
+      </para>
+
+      <para>When installing your FreeBSD system,
+	<application>Sysinstall</application> asked if you would like to
+	install the ports collection.  If you chose no, you can follow
+	these instructions to obtain the ports collection.</para>
+
+      <procedure>
+	<title>Sysinstall Method</title>
+
+	<para>This method involves using
+	  <application>sysinstall</application> again to manually
+	  install the ports collection.</para>
+
+	<step>
+	  <para>As root, run <command>/stand/sysinstall</command> as
+	    shown below:</para>
+
+	  <screen>&prompt.root; /stand/sysinstall</screen>
+	</step>
+
+	<step>
+	  <para>Scroll down and select <literal>Configure</literal>,
+	    Press Enter</para>
+	</step>
+
+	<step>
+	  <para>Scroll down and select
+	    <literal>Distributions</literal>, Press Enter</para>
+	</step>
+
+	<step>
+	  <para>Scroll down to <literal>ports</literal>, Press the
+	    Space key</para>
+	</step>
+
+	<step>
+	  <para>Scroll up to <literal>Exit</literal>, Press
+	    Enter</para>
+	</step>
+
+	<step>
+	  <para>Select your desired installation media, such as CDROM,
+	    FTP, and so on.</para>
+	</step>
+
+	<step>
+	  <para>Follow the menus to Exit <application>sysinstall</application></para>
+	</step>
+      </procedure>
+
+      <para>The alternative method to obtain and keep your ports
+	collection up to date is by using
+	<application>CVSup</application>.  Look at the ports
+	<application>CVSup</application> file,
+	<filename>/usr/share/examples/cvsup/ports-supfile</filename>.
+	See <link linkend="cvsup">Using CVSup</link> (<xref
+	  linkend="cvsup">) for more information on using
+	<application>CVSup</application> and the mentioned file.</para>
+
+      <procedure>
+	<title>CVSup Method</title>
+
+	<para>This is a quick method to getting the ports collection
+	  using <application>CVSup</application>.  If you want to keep
+	  your ports tree up to date, or learn more about
+	  <application>CVSup</application>, read the previously
+	  mentioned sections.</para>
+
+	<step>
+	  <para>Install the <port>net/cvsup</port> port.  See <link
+	      linkend="cvsup-install">CVSup Installation</link> (<xref
+	      linkend="cvsup-install">) for more details.</para>
+	</step>
+
+	<step>
+	  <para>As root, copy
+	    <filename>/usr/share/examples/cvsup/ports-supfile</filename>
+	    to a new location, such as <filename>/root</filename> or your
+	      home directory</para>
+	</step>
+
+	<step>
+	  <para>Edit <filename>ports-supfile</filename></para>
+	</step>
+
+	<step>
+	  <para>Change <literal>CHANGE_THIS.FreeBSD.org</literal> to a
+	    <application>CVSup</application> near you.  See <link
+	      linkend="cvsup-mirrors">CVSupp Mirrors</link> (<xref
+	      linkend="cvsup-mirrors">) for a complete listing of mirror
+	    sites.</para>
+	</step>
+
+	<step>
+	  <para>Run <command>cvsup -g -L 2 &lt;path_to_supfile&gt;</command></para>
+
+	  <screen>&prompt.root; cvsup -g -L 2 /root/ports-supfile</screen>
+	</step>
+
+	<step>
+	  <para>Running this consequent times at later dates will
+	    download all the recent changes to your ports
+	    collection.</para>
+	</step>
+      </procedure>
+    </sect2>
+
     <sect2 id="ports-skeleton">
       <title>Installing Ports</title>