View | Details | Raw Unified | Return to bug 12765
Collapse All | Expand All

(-)ftp.html.orig (-1 / +27 lines)
Lines 67-73 Link Here
67
    <td valign="top">the ftp action to perform, defaulting to &quot;send&quot;.  
67
    <td valign="top">the ftp action to perform, defaulting to &quot;send&quot;.  
68
                     Currently supports &quot;put&quot;, &quot;get&quot;,
68
                     Currently supports &quot;put&quot;, &quot;get&quot;,
69
                     &quot;del&quot;, &quot;list&quot;, &quot;chmod&quot;,
69
                     &quot;del&quot;, &quot;list&quot;, &quot;chmod&quot;,
70
                     &quot;mkdir&quot; and &quot;rmdir&quot;.</td>
70
                     &quot;mkdir&quot;, &quot;rmdir&quot; and 
71
                     &quot;deltree&quot;.</td>
71
    <td valign="top" align="center">No</td>
72
    <td valign="top" align="center">No</td>
72
  </tr>
73
  </tr>
73
  <tr>
74
  <tr>
Lines 307-317 Link Here
307
    &lt;/fileset&gt;
308
    &lt;/fileset&gt;
308
</pre>
309
</pre>
309
310
311
or better invoke once the <code>&lt;ftp&gt;</code> task with
312
<code>&quot;deltree&quot;</code> action.
313
</p>
314
<p>
310
The directory specified in the <code>remotedir</code> parameter is never
315
The directory specified in the <code>remotedir</code> parameter is never
311
selected for remove, so if you need to remove it, specify its parent in
316
selected for remove, so if you need to remove it, specify its parent in
312
<code>remotedir</code> parameter and include it in the 
317
<code>remotedir</code> parameter and include it in the 
313
<code>&lt;fileset&gt;</code> pattern, like <code>&quot;somedir/**&quot;</code>.
318
<code>&lt;fileset&gt;</code> pattern, like <code>&quot;somedir/**&quot;</code>.
314
</p>
319
</p>
320
321
<h3>Deleting Trees</h3>
322
<p>The <code>&quot;deltree&quot;</code> action is a pseudo action used as a
323
commodity to delete, with only one task, an entire tree of files and 
324
directories.
325
This action is internally exploded into a <code>&quot;delete&quot;</code> and
326
then a <code>&quot;rmdir&quot;</code> actions using the same 
327
<code>remotedir</code> and filesets.
328
To be sure to succeed you must be sure the filesets patterns selects all the 
329
files and directories in the trees you want to delete.
330
All the recommendations of <code>&quot;rmdir&quot;</code> actions apply.
331
</p>
332
<p>
333
The advantage of using <code>&quot;deltree&quot;</code> action instead of
334
<code>&quot;delete&quot;</code> and then <code>&quot;rmdir&quot;</code>, 
335
other than writing only once the <code>&lt;ftp&gt;</code> task, is that
336
the scanning of <code>remotedir</code> for matching with filesets patterns
337
is done only once, which may be a bonus for large trees, large filesets
338
and slow servers or connections.
339
</p>
340
315
<hr>
341
<hr>
316
<p align="center">Copyright &copy; 2000-2002 Apache Software Foundation. All rights
342
<p align="center">Copyright &copy; 2000-2002 Apache Software Foundation. All rights
317
Reserved.</p>
343
Reserved.</p>

Return to bug 12765