From 1f77f2bf9f4d403024d19716399915c2728bdc79 Mon Sep 17 00:00:00 2001
From: Steve Loughran <stevel@apache.org>
Date: Wed, 17 Aug 2005 10:06:01 +0000
Subject: [PATCH] documenting passive FTP

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@278519 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/OptionalTasks/ftp.html | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/docs/manual/OptionalTasks/ftp.html b/docs/manual/OptionalTasks/ftp.html
index 5d582985e..6b0600e16 100644
--- a/docs/manual/OptionalTasks/ftp.html
+++ b/docs/manual/OptionalTasks/ftp.html
@@ -14,7 +14,10 @@
 list, delete files, and create directories.  See below for descriptions and examples of how
 to perform each task.</p>
 <p><b>Note:</b> This task depends on external libraries not included in the Ant distribution.
-See <a href="../install.html#commons-net">Library Dependencies</a> for more information.</p>
+See <a href="../install.html#commons-net">Library Dependencies</a> for more information.
+<i>Get the latest version of this library, for the best support in Ant</i>
+
+</p>
 <p>The ftp task attempts to determine what file system is in place on the FTP server.
 Supported server types are Unix, NT, OS2, VMS, and OS400.  In addition, NT and OS400 servers
 which have been configured to display the directory in Unix style are also supported correctly.
@@ -31,11 +34,17 @@ This task does not currently use the proxy information set by the
 <a href="setproxy.html"><code>&lt;setproxy&gt;</code></a> task, and cannot go through
 a firewall via socks. 
 <p>
-<b>Warning: </b> there have been problems reported concerning the ftp get with newer attribute.
+<b>Warning: </b> there have been problems reported concerning the ftp get with the <code>newer</code> attribute.
 Problems might be due to format of ls -l differing from what is expected by commons-net,
 for instance due to specificities of language used by the ftp server in the directory listing.
 If you encounter such a problem, please send an email including a sample directory listing
 coming from your ftp server (ls -l on the ftp prompt).
+</p>
+<p>
+If you can connect but not upload or download, try setting the <code>passive</code>
+attribute to true to use the existing (open) channel, instead of having the server
+try to set up a new connection.</p>
+
 <h3>Parameters</h3>
 <table border="1" cellpadding="2" cellspacing="0">
   <tr>
@@ -89,7 +98,9 @@ coming from your ftp server (ls -l on the ftp prompt).
   </tr>
   <tr>
     <td valign="top">passive</td>
-    <td valign="top">selects passive-mode ("yes") transfers.
+    <td valign="top">selects passive-mode ("yes") transfers, for
+                     better through-firewall connectivity, at the price
+                     of performance.
                      Defaults to "no"</td>
     <td valign="top" align="center">No</td>
   </tr>