added package mapper as an official mapper type

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@270486 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/CoreTypes/mapper.html

@@ -340,6 +340,32 @@ jakarta-ORO and finally try jakarta-regexp.</li>
   </tr>
 </table>
 
+<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
+directory separators found in the matched source pattern with dots in the target
+pattern placeholder. This mapper is particularly useful in combination
+with <code>&lt;uptodate&gt;</code> and <code>&lt;junit&gt;</code> output.</p>
+<b>Example:</b>
+<blockquote><pre>
+&lt;mapper type="package"
+        from="*Test.java" to="TEST-*Test.xml"/&gt;
+</pre></blockquote>
+<table border="1" cellpadding="2" cellspacing="0">
+  <tr>
+    <td valign="top"><b>Source file name</b></td>
+    <td valign="top"><b>Target file name</b></td>
+  </tr>
+  <tr>
+    <td valign="top"><code>org/apache/tools/ant/util/PackageMapperTest.java</code></td>
+    <td valign="top"><code>TEST-org.apache.tools.ant.util.PackageMapperTest.xml</code></td>
+  </tr>
+  <tr>
+    <td valign="top"><code>org/apache/tools/ant/util/Helper.java</code></td>
+    <td valign="top">ignored</td>
+  </tr>
+</table>
+
 <hr>
 <p align="center">Copyright &copy; 2000,2001 Apache Software Foundation. All rights
 Reserved.</p>

src/main/org/apache/tools/ant/types/Mapper.java

@@ -258,10 +258,13 @@ public class Mapper extends DataType implements Cloneable {
                                 "org.apache.tools.ant.util.MergingMapper");
             implementations.put("regexp", 
                                 "org.apache.tools.ant.util.RegexpPatternMapper");
+            implementations.put("package", 
+                                "org.apache.tools.ant.util.PackageNameMapper");
         }
 
         public String[] getValues() {
-            return new String[] {"identity", "flatten", "glob", "merge", "regexp"};
+            return new String[] {"identity", "flatten", "glob", 
+                                 "merge", "regexp", "package"};
         }
 
         public String getImplementation() {