@@ -12,58 +12,58 @@
<h3>Description</h3>
<h3>Description</h3>
<p>
<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>
<p>
<p>
<a href="../using.html#path">Path</a>s and/or
<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>
</p>
<h3>Parameters</h3>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<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.
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">
<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>.
<em>since Ant 1.6</em>.
Defaults to "yes".
Defaults to "yes".
</td>
<td valign="top" align="center">No</td>
</tr>
</td>
<td valign="top" align="center">No</td>
</tr>
<tr>
<tr>
<td valign="top">encoding</td>
<td valign="top">encoding</td>
@@ -89,7 +89,7 @@
<tr>
<tr>
<td valign="top">fixlastline</td>
<td valign="top">fixlastline</td>
<td valign="top">
<td valign="top">
Specifies whether or not to check if
Specifies whether or not to check if
each file concatenated is terminated by
each file concatenated is terminated by
a new line. If this attribute is "yes"
a new line. If this attribute is "yes"
a new line will be appended to the stream if
a new line will be appended to the stream if
@@ -108,17 +108,17 @@
<em>since Ant 1.6</em>
<em>since Ant 1.6</em>
Valid values for this property are:
Valid values for this property are:
<ul>
<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.
The default is platform dependent.
For Unix platforms, the default is "lf".
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".
For Mac OS, the default is "cr".
</td>
</td>
<td valign="top" align="center">No</td>
<td valign="top" align="center">No</td>
@@ -131,7 +131,7 @@
<p><em>since Ant 1.6</em>.</p>
<p><em>since Ant 1.6</em>.</p>
<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
used to select file files to be concatenated. Note that
a file can only appear once in a path. If this is
a file can only appear once in a path. If this is
an issue consider using multiple paths.
an issue consider using multiple paths.
@@ -140,11 +140,11 @@
<h4>fileset</h4>
<h4>fileset</h4>
<p>
<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>
</p>
<h4>filelist</h4>
<h4>filelist</h4>
@@ -156,7 +156,7 @@
</p>
</p>
<h4>filterchain</h4>
<h4>filterchain</h4>
<p><em>since Ant 1.6</em>.</p>
<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>
<a href="../CoreTypes/filterchain.html"> FilterChain</a>s.</p>
<h4>header,footer</h4>
<h4>header,footer</h4>
@@ -226,10 +226,10 @@
<pre>
<pre>
<concat destfile="${docbook.dir}/all-sections.xml"
<concat destfile="${docbook.dir}/all-sections.xml"
force="no">
force="no">
<filelist dir="${docbook.dir}/sections"
<filelist dir="${docbook.dir}/sections"
files="introduction.xml,overview.xml"/>
files="introduction.xml,overview.xml"/>
<fileset dir="${docbook.dir}"
includes="sections/*.xml"
<fileset dir="${docbook.dir}"
includes="sections/*.xml"
excludes="introduction.xml,overview.xml"/>
excludes="introduction.xml,overview.xml"/>
</concat>
</concat>
</pre>
</pre>
@@ -267,10 +267,10 @@
<hr>
<hr>
<p align="center">
<p align="center">
Copyright © 2002-2004 The Apache Software Foundation. All
Rights Reserved.
Copyright © 2002-2004 The Apache Software Foundation. All
Rights Reserved.
</p>
</p>
</body>
</body>
</html>
</html>