From p@i609.hadiko.de  Wed Sep 13 13:19:54 2000
Return-Path: <p@i609.hadiko.de>
Received: from mailgate.rz.uni-karlsruhe.de (mailgate.rz.uni-karlsruhe.de [129.13.64.97])
	by hub.freebsd.org (Postfix) with ESMTP id DB01B37B42C
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 13 Sep 2000 13:19:53 -0700 (PDT)
Received: from nce2.hadiko.de (hadince2.hadiko.uni-karlsruhe.de [172.20.32.2])
	by mailgate.rz.uni-karlsruhe.de with esmtp (Exim 3.02 #2)
	id 13ZJ0a-00037d-00; Wed, 13 Sep 2000 22:19:52 +0200
Received: from i609.hadiko.de (hadii609.hadiko.uni-karlsruhe.de [172.20.44.159])
	by nce2.hadiko.de (8.9.3/8.9.3) with ESMTP id WAA20686
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 13 Sep 2000 22:19:52 +0200 (MET DST)
Received: (from p@localhost)
	by i609.hadiko.de (8.11.0/8.11.0) id e8DKJjQ01339;
	Wed, 13 Sep 2000 22:19:45 +0200 (CEST)
	(envelope-from p)
Message-Id: <200009132019.e8DKJjQ01339@i609.hadiko.de>
Date: Wed, 13 Sep 2000 22:19:45 +0200 (CEST)
From: Philipp Mergenthaler <p@i609.hadiko.de>
Reply-To: un1i@rz.uni-karlsruhe.de
To: FreeBSD-gnats-submit@freebsd.org
Subject: [PATCH] In install/chapter.sgml, explain FTP'ing via HTTP proxy
X-Send-Pr-Version: 3.2

>Number:         21254
>Category:       docs
>Synopsis:       [PATCH] In install/chapter.sgml, explain FTP'ing via HTTP proxy
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    alex
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Sep 13 13:20:01 PDT 2000
>Closed-Date:    Sun Sep 24 06:07:35 PDT 2000
>Last-Modified:  Sun Sep 24 06:16:15 PDT 2000
>Originator:     Philipp Mergenthaler
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
University of Karlsruhe
>Environment:

	$FreeBSD: doc/en_US.ISO_8859-1/books/handbook/install/chapter.sgml,v 1.58 2000/09/10 10:20:16 alex Exp $


>Description:

	The handbook only describes FTP proxies, whereas most proxies
	nowadays are HTTP proxies.

>How-To-Repeat:

	

>Fix:

I'm not a native speaker -- feel free to improve the wording :-).

--- chapter.sgml	Wed Sep 13 21:39:55 2000
+++ chapter.sgml.new	Wed Sep 13 22:16:08 2000
@@ -452,5 +452,5 @@
 	  you will also need a name server and possibly the address of a
 	  gateway (if you are using PPP, it is your provider's IP address)
-	  to use in talking to it.  If you do not know the answers to all
+	  to use in talking to it.  If you want to install by FTP via an HTTP proxy (see below), you will also need the proxy's address.  If you do not know the answers to all
 	  or most of these questions, then you should really probably talk
 	  to your system administrator or ISP <emphasis>before</emphasis> trying
@@ -508,6 +508,6 @@
 	  <screen><userinput>ftp://209.55.82.20/pub/FreeBSD/&rel.current;-RELEASE</userinput></screen>
 
-	  <para>There are two FTP installation modes you can choose from:
-	    active or passive FTP.</para>
+	  <para>There are three FTP installation modes you can choose from:
+	    active or passive FTP or via an HTTP proxy.</para>
 
 	  <variablelist>
@@ -536,10 +536,27 @@
 	      </listitem>
 	    </varlistentry>
+
+	    <varlistentry>
+	      <term>FTP via an HTTP proxy</term>
+
+	      <listitem>
+	        <para>This option instructs FreeBSD to use the HTTP
+		  protocol (like a web browser) to connect to a proxy
+		  for all FTP operations.  The proxy will translate
+		  the requests and send them to the FTP server.
+		  This allows the user to pass through firewalls
+		  that do not allow FTP at all, but offer an HTTP
+		  proxy.
+		  In this case, you have to specify the proxy in
+		  addition to the FTP server.</para>
+	      </listitem>
+	    </varlistentry>
 	  </variablelist>
 
 	  <note>
-	    <para>Active and passive modes are not the same as a
-	      <quote>proxy</quote> connection, where a proxy FTP server is
-	      listening and forwarding FTP requests!</para>
+	    <para>There is another type of FTP proxy other than HTTP
+	      proxies.  This type is very uncommon, though.  If you
+	      are not absolutely certain, you can assume that you
+	      have an HTTP proxy as described above.</para>
 	  </note>
 

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: alex 
State-Changed-When: Sun Sep 24 06:07:35 PDT 2000 
State-Changed-Why:  
Committed, thanks 


Responsible-Changed-From-To: freebsd-doc->alex 
Responsible-Changed-By: alex 
Responsible-Changed-When: Sun Sep 24 06:07:35 PDT 2000 
Responsible-Changed-Why:  
Mine 

http://www.freebsd.org/cgi/query-pr.cgi?pr=21254 
>Unformatted:
