From 763a0a2990b70d8a446e4e43a742a85c861b2c50 Mon Sep 17 00:00:00 2001
From: Nik Clayton <nik@FreeBSD.org>
Date: Sat, 29 Jun 2002 20:33:17 +0000
Subject: [PATCH] Explain that the ports system (and pkg_add -r) use
 fetch/libfetch to do their dirty work, and that the fetch(3) man page should
 be consulted to see which environment variables can be set for things like
 HTTP proxies.

PR:		docs/39796
Submitted by:	Jonathan Laventhol <jonathan-dot-laventhol@imagination.com>
---
 .../books/handbook/ports/chapter.sgml         | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
index 0a4452cf62..223f1303a8 100644
--- a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
@@ -315,8 +315,14 @@ local: lsof-4.56.4.tgz remote: lsof-4.56.4.tgz
         <primary><command>pkg_add</command></primary></indexterm>
       <screen>&prompt.root; <userinput>pkg_add -r <replaceable>lsof-4.56.4</replaceable></userinput></screen>
 
-      <para>The example above would download the correct package and add it without
-        any further user intervention.</para>
+      <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 
+	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 proxy.  See &man.fetch.3; for the 
+	complete list.</para></para>
 
       <para>Package files are distributed in .tgz format.  You can
           find them at <ulink
@@ -848,9 +854,12 @@ Receiving lsof_4.57D.freebsd.tar.gz (439860 bytes): 100%
         <para>As you can see, the only difference is the line that tells
 	  you where the system is fetching the port from.</para>
 
-        <para>That about does it for installing ports onto your
-	  system.  In the next section you will learn how to remove a
-	  port from your system.</para>
+	<para>The ports system uses &man.fetch.1; to download the files, 
+	  which honours 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
+	  proxy.  See &man.fetch.3; for the complete list.</para>
       </sect3>
     </sect2>