conor 2003/02/05 05:14:33
Modified: docs/manual/CoreTasks copy.html
docs/manual/CoreTypes filterset.html
Log:
Add warnings about the interaction of filters and binary files
PR: 16780
Revision Changes Path
1.14 +10 -0 jakarta-ant/docs/manual/CoreTasks/copy.html
Index: copy.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/manual/CoreTasks/copy.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -w -u -r1.13 -r1.14
--- copy.html 4 Sep 2002 11:05:16 -0000 1.13
+++ copy.html 5 Feb 2003 13:14:33 -0000 1.14
@@ -13,10 +13,20 @@
only copied if the source file is newer than the destination file,
or when the destination file does not exist. However, you can explicitly
overwrite files with the <code>overwrite</code> attribute.</p>
+
<p><a href="../CoreTypes/fileset.html">FileSet</a>s are used to select a
set of files to copy.
To use a <code><fileset></code>, the <code>todir</code> attribute
must be set.</p>
+
+<p>
+<strong>Note: </strong>If you employ filters in your copy operation, you
should
+limit the copy to text files. Binary files will be corrupted by the copy
operation.
+This applies whether the filters are implicitly defined by the
+<a href="filter.html">filter</a> task or explicitly provided to the copy
+operation as <a href="../CoreTypes/filterset.html">filtersets</a>
+</p>
+
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
1.12 +7 -0 jakarta-ant/docs/manual/CoreTypes/filterset.html
Index: filterset.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/manual/CoreTypes/filterset.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -w -u -r1.11 -r1.12
--- filterset.html 27 Sep 2002 09:30:37 -0000 1.11
+++ filterset.html 5 Feb 2003 13:14:33 -0000 1.12
@@ -28,6 +28,13 @@
<p>Filtersets are used for doing
replacements in tasks such as <code><copy></code>, etc.</p>
+<p>
+<strong>Note: </strong>When a filterset is used in an operation, the files
are
+processed in text mode and the filters applied line by line. This means that
+the copy operations will typically corrupt binary files. When applying
filters
+you should ensure that the set of files being filtered are all text files.
+</p>
+
<H2>Filterset</H2>
<TABLE cellSpacing=0 cellPadding=2 border=1>
