Browse Source

Add separators between the mappers for easier reading of the source code. (Like it was before Script Mapper and Filter Mapper).

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@494794 13f79535-47bb-0310-9956-ffa450edef68
master
Jan Materne 18 years ago
parent
commit
da516c73ec
1 changed files with 45 additions and 0 deletions
  1. +45
    -0
      docs/manual/CoreTypes/mapper.html

+ 45
- 0
docs/manual/CoreTypes/mapper.html View File

@@ -109,6 +109,11 @@ implicitly configured as a <a href="#composite-mapper">composite mapper</a>.
the generally available <i>to</i> and <i>from</i>.<br>
The <code>&lt;mapper type|classname=&quot;...&quot;&gt;</code> usage
form remains valid for reasons of backward compatibility.</p>

<!-- -->
<!-- Identity Mapper -->
<!-- -->

<h4><a name="identity-mapper">identity</a></h4>
<p>The target file name is identical to the source file name. Both
<code>to</code> and <code>from</code> will be ignored.</p>
@@ -139,6 +144,11 @@ implicitly configured as a <a href="#composite-mapper">composite mapper</a>.
<td valign="top"><code>Classes/dir/dir2/A.properties</code></td>
</tr>
</table>

<!-- -->
<!-- Flatten Mapper -->
<!-- -->

<h4><a name="flatten-mapper">flatten</a></h4>
<p>The target file name is identical to the source file name, with all
leading directory information stripped off. Both <code>to</code> and
@@ -170,6 +180,11 @@ leading directory information stripped off. Both <code>to</code> and
<td valign="top"><code>A.properties</code></td>
</tr>
</table>

<!-- -->
<!-- Merge Mapper -->
<!-- -->

<h4><a name="merge-mapper">merge</a></h4>
<p>The target file name will always be the same, as defined by
<code>to</code> - <code>from</code> will be ignored.</p>
@@ -200,6 +215,11 @@ leading directory information stripped off. Both <code>to</code> and
<td valign="top"><code>archive.tar</code></td>
</tr>
</table>

<!-- -->
<!-- Glob Mapper -->
<!-- -->

<h4><a name="glob-mapper">glob</a></h4>
<p>Both <code>to</code> and <code>from</code> define patterns that may
contain at most one <code>*</code>. For each source file that matches
@@ -324,6 +344,11 @@ that don't match the <code>from</code> pattern will be ignored.</p>
will output "x is f/j.java".
</p>


<!-- -->
<!-- RegExp Mapper -->
<!-- -->

<h4><a name="regexp-mapper">regexp</a></h4>
<p>Both <code>to</code> and <code>from</code> define regular
expressions. If the source file name matches the <code>from</code>
@@ -535,6 +560,11 @@ jakarta-ORO and finally try jakarta-regexp.</li>
<p>
will set <code>hd.prop</code> to "f\j.java".
</p>

<!-- -->
<!-- Package Mapper -->
<!-- -->

<h4><a name="package-mapper">package</a></h4>
<p>Sharing the same syntax as the <a href="#glob-mapper">glob mapper</a>,
the package mapper replaces
@@ -560,6 +590,11 @@ with <code>&lt;uptodate&gt;</code> and <code>&lt;junit&gt;</code> output.</p>
<td valign="top">ignored</td>
</tr>
</table>

<!-- -->
<!-- Unpackage Mapper -->
<!-- -->

<h4><a name="unpackage-mapper">unpackage (since Ant 1.6.0)</a></h4>
<p>This mapper is the inverse of the <a href="#package-mapper">package</a> mapper.
It replaces the dots in a package name with directory separators. This
@@ -582,6 +617,11 @@ with <code>&lt;uptodate&gt;</code> and <code>&lt;junit&gt;</code> output.</p>
<td valign="top"><code>${test.src.dir}/org/acme/AcmeTest.java</code></td>
</tr>
</table>

<!-- -->
<!-- Composite Mapper -->
<!-- -->

<h4><a name="composite-mapper">composite (since Ant 1.6.2)</a></h4>
<p>This mapper implementation can contain multiple nested mappers.
File mapping is performed by passing the source filename to each nested
@@ -610,6 +650,11 @@ with <code>&lt;uptodate&gt;</code> and <code>&lt;junit&gt;</code> output.</p>
<p>The composite mapper has no corresponding
<code>&lt;mapper <b>type</b>&gt;</code> attribute.
</p>

<!-- -->
<!-- Chained Mapper -->
<!-- -->

<h4><a name="chained-mapper">chained (since Ant 1.6.2)</a></h4>
<p>This mapper implementation can contain multiple nested mappers.
File mapping is performed by passing the source filename to the first


Loading…
Cancel
Save