antoine 2003/08/07 15:20:34 Modified: docs/manual/OptionalTasks ftp.html Log: There have been several bug reports showing that users did not understand the meaning of remotedir and of the nested fileset(s) for the different actions of the ftp task. I have added a table to explain this. Also removed the warning concerning Win2000 ftp servers (I am not sure the problem is still actual) and added instead a warning concerning the newer option. PR: 13876 Revision Changes Path 1.17 +95 -8 ant/docs/manual/OptionalTasks/ftp.html Index: ftp.html =================================================================== RCS file: /home/cvs/ant/docs/manual/OptionalTasks/ftp.html,v retrieving revision 1.16 retrieving revision 1.17 diff -u -r1.16 -r1.17 --- ftp.html 6 Aug 2003 10:58:24 -0000 1.16 +++ ftp.html 7 Aug 2003 22:20:34 -0000 1.17 @@ -28,10 +28,11 @@ <a href="setproxy.html"><setproxy></a> task, and cannot go through a firewall via socks. <p> -<b>Warning: </b> for the get and delete actions to work properly -with a Windows 2000 ftp server, it needs to be configured to generate -Unix style listings, and not the default MS-DOS listing. Or someone needs to write -the code to parse MS-DOS listings -any takers? +<b>Warning: </b> there have been problems reported concerning the ftp get with newer attribute. +Problems might be due to format of ls -l differing from what is expected by commons-net, +for instance due to specificities of langage 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). <h3>Parameters</h3> <table border="1" cellpadding="2" cellspacing="0"> <tr> @@ -62,8 +63,10 @@ </tr> <tr> <td valign="top">remotedir</td> - <td valign="top">the directory to which to upload files on the - ftp server.</td> + <td valign="top">remote directory on the + ftp server + see table below for detailed usage + </td> <td valign="top" align="center">No</td> </tr> <tr> @@ -150,7 +153,91 @@ <td valign="top" align="center">No; defaults to false.</td> </tr> </table> -<h3>Parameters specified as nested elements</h3> +<h3>Note about remotedir attribute</h3> +<table border="1" cellpadding="2" cellspacing="0" + > + <tbody> + <tr> + <td style="vertical-align: top;" width="20%">Action<br> + </td> + <td style="vertical-align: top;" width="40%">meaning of <code>remotedir</code><br> + </td> + <td style="vertical-align: top;">use of nested <code>fileset</code> +(s)<br> + </td> + </tr> + <tr> + <td style="vertical-align: top;" width="20%">send/put<br> + </td> + <td style="vertical-align: top;" width="40%">base directory to +which the files are sent<br> + </td> + <td style="vertical-align: top;">they are used normally and +evaluated on the local machine<br> + </td> + </tr> + <tr> + <td style="vertical-align: top;" width="20%">recv/get<br> + </td> + <td style="vertical-align: top;" width="40%">base directory from +which the files are retrieved<br> + </td> + <td style="vertical-align: top;">the remote files located under +the <code>remotedir </code>matching the include/exclude patterns of +the <code>fileset </code></td> + </tr> + <tr> + <td style="vertical-align: top;" width="20%">del/delete<br> + </td> + <td style="vertical-align: top;" width="40%">base directory from +which files get deleted<br> + </td> + <td style="vertical-align: top;">the remote files located under +the <code>remotedir </code>matching the include/exclude patterns of +the <code>fileset <br> + </code></td> + </tr> + <tr> + <td style="vertical-align: top;" width="20%">list<br> + </td> + <td style="vertical-align: top;" width="40%">base directory from +which files are listed<br> + </td> + <td style="vertical-align: top;">the remote files located under +the <code>remotedir </code>matching the include/exclude patterns of +the <code>fileset <br> + </code></td> + </tr> + <tr> + <td style="vertical-align: top;" width="20%">mkdir</td> + <td style="vertical-align: top;" width="40%">directory to create<br> + </td> + <td style="vertical-align: top;">not used<br> + </td> + </tr> + <tr> + <td style="vertical-align: top;" width="20%">chmod</td> + <td style="vertical-align: top;" width="40%">base directory from +which the mode of files get changed<br> + </td> + <td style="vertical-align: top;">the remote files located under +the <code>remotedir </code>matching the include/exclude patterns of +the <code>fileset <br> + </code></td> + </tr> + <tr> + <td style="vertical-align: top;" width="20%">rmdir<br> + </td> + <td style="vertical-align: top;" width="40%">base directory from +which directories get removed<br> + </td> + <td style="vertical-align: top;">the remote directories located +under the <code>remotedir </code>matching the include/exclude +patterns of the <code>fileset <br> + </code></td> + </tr> + </tbody> +</table><h3>Parameters specified as nested elements</h3> <h4>fileset</h4> <p>The ftp task supports any number of nested <a href="../CoreTypes/fileset.html"><code><fileset></code></a> elements to specify @@ -337,7 +424,7 @@ <code><fileset></code> pattern, like <code>"somedir/**"</code>. </p> <hr> -<p align="center">Copyright © 2000-2002 Apache Software Foundation. All rights +<p align="center">Copyright © 2000-2003 Apache Software Foundation. All rights Reserved.</p> </body>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]