From 0f2972d8c9f20415ab5b2da4140088456aa45927 Mon Sep 17 00:00:00 2001
From: "Jordan K. Hubbard" <jkh@FreeBSD.org>
Date: Sun, 4 Oct 1998 01:14:38 +0000
Subject: [PATCH] Vastly simplify section 4.3.1 now that the ports collection
 has gotten smarter (long ago) about CDROMs.

---
 handbook/ports.sgml | 66 +++++----------------------------------------
 1 file changed, 7 insertions(+), 59 deletions(-)

diff --git a/handbook/ports.sgml b/handbook/ports.sgml
index 29aaa98616..3325ffe39d 100644
--- a/handbook/ports.sgml
+++ b/handbook/ports.sgml
@@ -1,4 +1,4 @@
-<!-- $Id: ports.sgml,v 1.30 1998-04-28 04:53:27 mph Exp $ -->
+<!-- $Id: ports.sgml,v 1.31 1998-10-04 01:14:38 jkh Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
 <chapt><heading>Installing Applications: The Ports collection<label id="ports"></heading>
@@ -186,64 +186,12 @@ name="Internet Connection.">
 
 <sect1><heading>Compiling ports from CDROM<label id="ports:cd"></heading>
 <p>
-If you answered yes to the question ``Do you want to link the ports 
-collection to your CDROM'' during the FreeBSD installation, the initial
-setting up will already have been done for you.
-<p>
-If not, make sure the <em /FreeBSD/ CDROM is in the drive and mounted on, 
-say, /cdrom. Then do
+Assuming that your <em /FreeBSD/ CDROM is in the drive and mounted on
+/cdrom (and the mount point *must* be /cdrom), you should then be able
+to build ports just as you normally do and the port collection's built
+in search path should find the tarballs in file:/cdrom/ports/distfiles/
+(if they exist there) rather than downloading them over the net.
 
-<verb>
- # mkdir /usr/ports
- # cd /usr/ports
- # ln -s /cdrom/ports/distfiles distfiles
-</verb>
-
-to enable the ports make mechanism to find the tarballs (it expects to
-find them in /usr/ports/distfiles, which is why we sym-linked the
-CDROM's tarball directory to that directory).
-<p>
-Now, suppose you want to install the gnats program from the databases
-directory. Here is how to do it:-
-
-<verb>
- # cd /usr/ports
- # mkdir databases
- # cp -R /cdrom/ports/databases/gnats databases
- # cd databases/gnats
- # make install
-</verb>
-
-Or if you are a serious database user and you want to compare all the
-ones available in the Ports collection, do
-
-<verb>
- # cd /usr/ports
- # cp -R /cdrom/ports/databases .
- # cd databases
- # make install
-</verb>
-
-(yes, that really is a dot on its own after the cp command and not a
-mistake. It is Unix-ese for ``the current directory'')
-<p>
-and the ports make mechanism will automatically compile and install
-all the ports in the databases directory for you!
-<p>
-If you do not like this method, here is a completely different way of
-doing it:-
-<p>
-Create a "link tree" to it using the <tt>lndir(1)</tt> command that
-comes with the <em>XFree86</em> distribution.  Find a location with
-some free space, create a directory there and then cd to it.  Then
-invoke the <tt>lndir(1)</tt> command with the full pathname of the ``ports''
-directory on the CDROM as the first argument and . (the current directory)
-as the second.  This might be, for example, something like:
-<verb>
-	lndir /cdrom/ports .
-</verb>
-<p>Then you can build ports directly off the CDROM by building them in the
-link tree you have created.
 <p>
 Note that there are some ports for which we cannot provide the original
 source in the CDROM due to licensing limitations.  In that case,
@@ -336,7 +284,7 @@ installed. Here is the Makefile for ElectricFence:-
 # Date created: 	13 November 1997
 # Whom:			jraynard
 #
-# $Id: ports.sgml,v 1.30 1998-04-28 04:53:27 mph Exp $
+# $Id: ports.sgml,v 1.31 1998-10-04 01:14:38 jkh Exp $
 #
 
 DISTNAME=	ElectricFence-2.0.5