From 39adab85e5976041c8abd9866917092134edef05 Mon Sep 17 00:00:00 2001
From: Tom Rhodes <trhodes@FreeBSD.org>
Date: Tue, 20 May 2003 19:41:29 +0000
Subject: [PATCH] Final touches:

Update the synopsis.
Add a man xref to the distfile description.
Add a 'dealing with imake' section.
Fix 2 spelling errors while I'm here.
---
 .../books/handbook/ports/chapter.sgml         | 28 +++++++++++++++++--
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
index b73ccb7a80..1b19322805 100644
--- a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
@@ -35,6 +35,13 @@
       <listitem>
 	<para>How to remove previously installed packages or ports.</para>
       </listitem>
+      <listitem>
+	<para>How to override default the default values that the ports
+	  collection uses.</para>
+      </listitem>
+      <listitem>
+	<para>How to upgrade your ports.</para>
+      </listitem>
     </itemizedlist>
   </sect1>
 
@@ -317,7 +324,7 @@ local: lsof-4.56.4.tgz remote: lsof-4.56.4.tgz
 
       <para>The example above would download the correct package and add 
 	it without any further user intervention.  &man.pkg.add.1; uses 
-	  &man.fetch.3; to download the files, which honours various 
+	  &man.fetch.3; to download the files, which honors various 
 	environment variables, including <envar>FTP_PASSIVE_MODE</envar>, 
 	<envar>FTP_PROXY</envar>, and <envar>FTP_PASSWORD</envar>.  You 
 	may need to set one or more of these if you are behind a firewall, 
@@ -597,7 +604,7 @@ docbook                     =
 	  <para>A <filename>distinfo</filename> file.  This file contains
 	    information about the files that must be downloaded to build the
 	    port and their checksums, to verify that files have not been
-	    corrupted during the download.</para>
+	    corrupted during the download using &man.md5.1;.</para>
 	</listitem>
 	
 	<listitem>
@@ -873,7 +880,7 @@ Receiving lsof_4.57D.freebsd.tar.gz (439860 bytes): 100%
 	  you where the system is fetching the port distfile from.</para>
 
 	<para>The ports system uses &man.fetch.1; to download the files, 
-	  which honours various environment variables, including 
+	  which honors various environment variables, including 
 	  <envar>FTP_PASSIVE_MODE</envar>, <envar>FTP_PROXY</envar>, 
 	  and <envar>FTP_PASSWORD</envar>.  You may need to set one or more 
 	  of these if you are behind a firewall, or need to use an FTP/HTTP
@@ -939,6 +946,21 @@ Receiving lsof_4.57D.freebsd.tar.gz (439860 bytes): 100%
 	<para>will combine the two (it is too long to completely write on
 	  this page, but it should give you the general idea).</para>
 
+	<para>Alternatively, these variables can also be set
+	  as part of your environment.  Read the manual page for your shell for
+	  instructions on doing so.</para>
+      </sect3>
+
+      <sect3>
+	<title>Dealing with <command>imake</command></title>
+
+	<para>Some ports that use <command>imake</command> (a part of the X Windows
+	  System) do not work well with <makevar>PREFIX</makevar>, and will insist on
+	  installing under <filename>/usr/X11R6</filename>.  Similarly, some Perl ports
+	  ignore <makevar>PREFIX</makevar> and install in the Perl tree.  Making these
+	  ports respect <makevar>PREFIX</makevar> is a difficult or impossible
+	  job.</para>
+
       </sect3>
     </sect2>