@@ -12,58 +12,58 @@
<h3>Description</h3>
<p>
Concatenates a file, or a series of files, to a single file or
the console. The destination file will be created if it does
not exist.
Concatenates a file, or a series of files, to a single file or
the console. The destination file will be created if it does
not exist.
</p>
<p>
<a href="../using.html#path">Path</a>s and/or
<a href="../CoreTypes/fileset.html">FileSet</a>s and/or <a
href="../CoreTypes/filelist.html">FileList</a>s are used to
select which files are to be concatenated. There is no
singular 'file' attribute to specify a single file to cat.
<a href="../CoreTypes/fileset.html">FileSet</a>s and/or <a
href="../CoreTypes/filelist.html">FileList</a>s are used to
select which files are to be concatenated. There is no
singular 'file' attribute to specify a single file to cat.
</p>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
<td align="center" valign="top"><b>Required</b></td>
</tr>
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
<td align="center" valign="top"><b>Required</b></td>
</tr>
<tr>
<td valign="top">destfile</td>
<td valign="top">
The destination file for the concatenated stream.
<tr>
<td valign="top">destfile</td>
<td valign="top">
The destination file for the concatenated stream.
If not specified the console will be used instead.
</td>
<td valign="top" align="center">
No
</td>
</tr>
<tr>
<td valign="top">append</td>
<td valign="top">
Specifies whether or not the file specified by 'destfile'
should be appended. Defaults to "no".
</td>
<td valign="top" align="center">No</td>
</tr>
<tr>
<td valign="top">force</td>
</td>
<td valign="top" align="center">
No
</td>
</tr>
<tr>
<td valign="top">append</td>
<td valign="top">
Specifies whether or not the file specified by 'destfile'
should be appended. Defaults to "no".
</td>
<td valign="top" align="center">No</td>
</tr>
<tr>
<td valign="top">force</td>
<td valign="top">
Specifies whether or not the file specified by 'destfile'
should be written to even if it is newer than all source files.
Specifies whether or not the file specified by 'destfile'
should be written to even if it is newer than all source files.
<em>since Ant 1.6</em>.
Defaults to "yes".
</td>
<td valign="top" align="center">No</td>
</tr>
</td>
<td valign="top" align="center">No</td>
</tr>
<tr>
<td valign="top">encoding</td>
@@ -89,7 +89,7 @@
<tr>
<td valign="top">fixlastline</td>
<td valign="top">
Specifies whether or not to check if
Specifies whether or not to check if
each file concatenated is terminated by
a new line. If this attribute is "yes"
a new line will be appended to the stream if
@@ -108,17 +108,17 @@
<em>since Ant 1.6</em>
Valid values for this property are:
<ul>
<li>cr: a single CR</li>
<li>lf: a single LF</li>
<li>crlf: the pair CRLF</li>
<li>mac: a single CR</li>
<li>unix: a single LF</li>
<li>dos: the pair CRLF</li>
</ul>
<li>cr: a single CR</li>
<li>lf: a single LF</li>
<li>crlf: the pair CRLF</li>
<li>mac: a single CR</li>
<li>unix: a single LF</li>
<li>dos: the pair CRLF</li>
</ul>
The default is platform dependent.
For Unix platforms, the default is "lf".
For DOS based systems (including Windows),
the default is "crlf".
For DOS based systems (including Windows),
the default is "crlf".
For Mac OS, the default is "cr".
</td>
<td valign="top" align="center">No</td>
@@ -131,7 +131,7 @@
<p><em>since Ant 1.6</em>.</p>
<p>
This is a <a href="../CoreTypes/path.html ">Path</a>. This is
This is a <a href="../using.html#path ">Path</a>. This is
used to select file files to be concatenated. Note that
a file can only appear once in a path. If this is
an issue consider using multiple paths.
@@ -140,11 +140,11 @@
<h4>fileset</h4>
<p>
<a href="../CoreTypes/fileset.html">FileSet</a>s are used to
select files to be concatenated. Note that the order in which
the files selected from a fileset are concatenated is
<i>not</i> guaranteed. If this is an issue, use multiple
filesets or consider using filelists.
<a href="../CoreTypes/fileset.html">FileSet</a>s are used to
select files to be concatenated. Note that the order in which
the files selected from a fileset are concatenated is
<i>not</i> guaranteed. If this is an issue, use multiple
filesets or consider using filelists.
</p>
<h4>filelist</h4>
@@ -156,7 +156,7 @@
</p>
<h4>filterchain</h4>
<p><em>since Ant 1.6</em>.</p>
<p>The concat task supports nested
<p>The concat task supports nested
<a href="../CoreTypes/filterchain.html"> FilterChain</a>s.</p>
<h4>header,footer</h4>
@@ -226,10 +226,10 @@
<pre>
<concat destfile="${docbook.dir}/all-sections.xml"
force="no">
<filelist dir="${docbook.dir}/sections"
<filelist dir="${docbook.dir}/sections"
files="introduction.xml,overview.xml"/>
<fileset dir="${docbook.dir}"
includes="sections/*.xml"
<fileset dir="${docbook.dir}"
includes="sections/*.xml"
excludes="introduction.xml,overview.xml"/>
</concat>
</pre>
@@ -267,10 +267,10 @@
<hr>
<p align="center">
Copyright © 2002-2004 The Apache Software Foundation. All
Rights Reserved.
Copyright © 2002-2004 The Apache Software Foundation. All
Rights Reserved.
</p>
</body>
</html>
</html>