a small explanation about this Maven stuff ...

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

src/etc/poms/README.txt

@@ -0,0 +1,60 @@
+Building Ant with Maven
+-----------------------
+
+The Ant jars can be built using Maven and the POMS present in this directory.
+
+Libs not available in the maven repository
+
+groupId          artifactId       version   comment
+xerces           xerces-impl      2.8.1     the xercesImpl.jar supplied with ant is the right one
+xml-apis         xml-apis         2.8.1     the xml-apis.jar supplied with ant is the right one
+com.bea          weblogic         8.1.3.0   download it
+com.bea          weblogicclasses  5.1       a newer version can do.
+jai              jai-core         1.1.2_01  download jai from sun
+jai              jai-codec        1.1.2.1   download jai from sun
+javax.media      jmf              2.1.1e    dowmload jmf from sun
+com.jcraft       jsch             0.1.29    download from jcraft
+com.ibm.netrexx  netrexx          2.0.5     I used the file NetRexxC.jar from the netrexx distribution
+com.starteam     starteam-sdk     5.2       the original file is called starteam-sdk.jar
+stylebook        stylebook        1.0-b2    the original file is called stylebook-1.0-b2.jar
+
+to install a jar file into your local Maven cache, do this
+
+mvn install:install-file -DgroupId=foo.org -DartifactId=xx -Dversion=x.y -Dpackaging=jar -Dfile=/a/b/foo.jar
+
+HOW TO BUILD :
+
+from this directory, type 
+
+mvn install (or mvn package)
+
+If you do not have all the dependencies, you can remove the modules that you will not be able to build 
+from the pom.xml in this directory.
+
+You also might want to disable the tests. 
+
+mvn install -Dmaven.test.skip=true 
+
+
+
+TODO :
+
+ * write MAVEN-UPLOAD request for xerces, xml-apis, and jsch.
+
+ * see if the dependency to weblogicclasses.jar can be replaced by a dependency to some j2ee.jar from Sun,
+as it supplies some javax.ejb classes which are required at compile time.
+
+
+PROBLEMS :
+
+ * the unit tests cannot run properly, the maven-surefire-plugin sets a system property basedir 
+which make a large part of our tests fail
+
+ * JIRA issue http://jira.codehaus.org/browse/MSUREFIRE-177 asking the Maven colleagues to fix this. :-)
+
+REFERENCES :
+
+about skipping tests :
+http://maven.apache.org/plugins/maven-surefire-plugin/examples/skipping-test.html
+
+