You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by hb...@apache.org on 2010/07/17 15:56:48 UTC
svn commit: r965079 - in /maven/ant-tasks/trunk/src/site:
apt/examples/mvn.apt.vm apt/examples/pom.apt apt/examples/write-pom.apt
apt/index.apt apt/reference.apt fml/faq.fml
Author: hboutemy
Date: Sat Jul 17 13:56:47 2010
New Revision: 965079
URL: http://svn.apache.org/viewvc?rev=965079&view=rev
Log:
polished documentation
Modified:
maven/ant-tasks/trunk/src/site/apt/examples/mvn.apt.vm
maven/ant-tasks/trunk/src/site/apt/examples/pom.apt
maven/ant-tasks/trunk/src/site/apt/examples/write-pom.apt
maven/ant-tasks/trunk/src/site/apt/index.apt
maven/ant-tasks/trunk/src/site/apt/reference.apt
maven/ant-tasks/trunk/src/site/fml/faq.fml
Modified: maven/ant-tasks/trunk/src/site/apt/examples/mvn.apt.vm
URL: http://svn.apache.org/viewvc/maven/ant-tasks/trunk/src/site/apt/examples/mvn.apt.vm?rev=965079&r1=965078&r2=965079&view=diff
==============================================================================
--- maven/ant-tasks/trunk/src/site/apt/examples/mvn.apt.vm (original)
+++ maven/ant-tasks/trunk/src/site/apt/examples/mvn.apt.vm Sat Jul 17 13:56:47 2010
@@ -28,7 +28,7 @@
The Mvn Task
- <<Note: This task is available since version 2.0.10 of the maven ant tasks>>
+ <<Note: This task is available since version 2.0.10 of the Maven Ant Tasks>>
The Maven Ant Tasks have some limited support for calling a full Maven build from Ant.
The <<<mvn>>> task is a subclass of the Ant {{{http://ant.apache.org/manual/CoreTasks/java.html}java}}
@@ -69,11 +69,11 @@ Running the Mvn Task without a Maven Ins
</artifact:mvn>
-----
- <<Note: this will use version ${mavenVersion} of the core Maven libraries contained in the ant tasks jar>>
+ <<Note: this will use version ${mavenVersion} of the core Maven libraries, contained in the Maven Ant Tasks jar>>
Using the Java Task
- The java task can be used directly without any need for the Maven Ant Tasks. However,
+ The java task can be used directly without any need for the Maven Ant Tasks. However,
this method requires that Maven is already installed on the system. A
property called <<<maven.home>>> must be set to point to the local Maven installation,
then an Ant macro can be defined for calling Maven.
@@ -105,7 +105,7 @@ Using the Java Task
</macrodef>
-----
- This example defines an Ant macro called <<<maven>>>. The macro can then be used in
+ This example defines an Ant macro called <<<maven>>>. The macro can then be used in
the build like this:
-----
Modified: maven/ant-tasks/trunk/src/site/apt/examples/pom.apt
URL: http://svn.apache.org/viewvc/maven/ant-tasks/trunk/src/site/apt/examples/pom.apt?rev=965079&r1=965078&r2=965079&view=diff
==============================================================================
--- maven/ant-tasks/trunk/src/site/apt/examples/pom.apt (original)
+++ maven/ant-tasks/trunk/src/site/apt/examples/pom.apt Sat Jul 17 13:56:47 2010
@@ -35,13 +35,14 @@ Introduction
can be used to resolve build dependencies, build the project classpath, and/or
define project properties.
-Reading an exising POM file
+Reading an existing POM file
An example pom is provided here:
-----
<project>
<modelVersion>4.0.0</modelVersion>
+
<groupId>com.mycompany.project</groupId>
<artifactId>project-model</artifactId>
<version>1.0-SNAPSHOT</version>
@@ -82,7 +83,7 @@ Reading an exising POM file
* <version> - the version of the artifact you are building.
- * <dependencies> - the artifacts that this project is dependant on.
+ * <dependencies> - the artifacts that this project is dependent on.
This is all that is required for most projects. However, it is also possible to use other fields available in
Maven to describe your project, and reference them from your build script.
@@ -96,7 +97,7 @@ Reading an exising POM file
Defining a POM in Ant
If a POM file is not available, the ant task can also be used to define an in-memory pom.
-
+
----
<artifact:pom id="mypom" groupId="org.acme" artifactId="project1" version="1.0">
<dependency groupId="junit" artifactId="junit" version="4.1"/>
@@ -125,7 +126,8 @@ Accessing POM information
<echo>The build directory is ${mypom.build.directory}</echo>
-----
- For more information on the elements available in the POM, see the {{{http://maven.apache.org/maven-model/maven.html} descriptor reference}}.
+ For more information on the elements available in the POM, see the
+ {{{http://maven.apache.org/ref/current/maven-model/maven.html} descriptor reference}}.
Accessing dependencies in the POM
Modified: maven/ant-tasks/trunk/src/site/apt/examples/write-pom.apt
URL: http://svn.apache.org/viewvc/maven/ant-tasks/trunk/src/site/apt/examples/write-pom.apt?rev=965079&r1=965078&r2=965079&view=diff
==============================================================================
--- maven/ant-tasks/trunk/src/site/apt/examples/write-pom.apt (original)
+++ maven/ant-tasks/trunk/src/site/apt/examples/write-pom.apt Sat Jul 17 13:56:47 2010
@@ -28,10 +28,10 @@
The WritePom Task
- <<Note: This task is available since version 2.1.0 of the maven ant tasks>>
+ <<Note: This task is available since version 2.1.0 of the Maven Ant Tasks>>
- The WritePom task can be used to generate a POM file based on information defined in
- the Ant build. For example, this could be used to generate a POM used when
+ The WritePom task can be used to generate a POM file based on information defined in
+ the Ant build. For example, this could be used to generate a POM used when
deploying build artifacts to a Maven repository.
The first step is to define a pom using the pom task.
@@ -45,28 +45,32 @@ The WritePom Task
----
The next step is to call the writePom task using the pom id created above.
-
+
----
<artifact:writepom pomRefId="mypom1" file="target/mypom1.xml"/>
----
This will generate a pom in the location specified.
-
+
----
<?xml version="1.0" encoding="UTF-8"?>
<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<modelVersion>4.0.0</modelVersion>
+
<groupId>org.acme</groupId>
<artifactId>project1</artifactId>
<version>1.0</version>
+
<name>My awesome project</name>
+
<licenses>
<license>
<name>apache</name>
<url>http://www.apache.org/</url>
</license>
</licenses>
+
<dependencies>
<dependency>
<groupId>junit</groupId>
@@ -82,12 +86,11 @@ The WritePom Task
</dependency>
</dependencies>
</project>
-----
-
- By default the <<<writePom>>> task will not include unnecessary information such as build configuration,
+----
+
+ By default the <<<writePom>>> task will not include unnecessary information such as build configuration,
repositories, and profiles. If this information is needed in the pom, the "trim" option can be set to false.
----
<artifact:writepom pomRefId="mypom1" file="target/mypom1.xml" trim="false"/>
----
-
\ No newline at end of file
Modified: maven/ant-tasks/trunk/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/maven/ant-tasks/trunk/src/site/apt/index.apt?rev=965079&r1=965078&r2=965079&view=diff
==============================================================================
--- maven/ant-tasks/trunk/src/site/apt/index.apt (original)
+++ maven/ant-tasks/trunk/src/site/apt/index.apt Sat Jul 17 13:56:47 2010
@@ -89,6 +89,6 @@ Maven Ant Tasks
* {{{http://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html} Dependency Mechanism}}
- * {{{http://maven.apache.org/maven-settings/settings.html} Settings Reference}}
+ * {{{http://maven.apache.org/ref/current/maven-settings/settings.html} Settings Reference}}
- * {{{http://maven.apache.org/maven-model/maven.html} POM Reference}}
+ * {{{http://maven.apache.org/ref/current/maven-model/maven.html} POM Reference}}
Modified: maven/ant-tasks/trunk/src/site/apt/reference.apt
URL: http://svn.apache.org/viewvc/maven/ant-tasks/trunk/src/site/apt/reference.apt?rev=965079&r1=965078&r2=965079&view=diff
==============================================================================
--- maven/ant-tasks/trunk/src/site/apt/reference.apt (original)
+++ maven/ant-tasks/trunk/src/site/apt/reference.apt Sat Jul 17 13:56:47 2010
@@ -237,12 +237,13 @@
** <<<authentication>>>
The authentication element is used for passing a username, password and other credentials to the repository either
- on upload or download. The content is the same as for <<<server>>> in the {{{http://maven.apache.org/maven-settings/settings.html#class_server} settings reference}}.
+ on upload or download. The content is the same as for <<<server>>> in the
+ {{{http://maven.apache.org/ref/current/maven-settings/settings.html#class_server} settings reference}}.
** <<<proxy>>>
The proxy element is typically used for HTTP repositories. The content is the same as for <<<proxy>>> in the
- {{{http://maven.apache.org/maven-settings/settings.html#class_proxy} settings reference}}.
+ {{{http://maven.apache.org/ref/current/maven-settings/settings.html#class_proxy} settings reference}}.
* <<<{pom}>>>
Modified: maven/ant-tasks/trunk/src/site/fml/faq.fml
URL: http://svn.apache.org/viewvc/maven/ant-tasks/trunk/src/site/fml/faq.fml?rev=965079&r1=965078&r2=965079&view=diff
==============================================================================
--- maven/ant-tasks/trunk/src/site/fml/faq.fml (original)
+++ maven/ant-tasks/trunk/src/site/fml/faq.fml Sat Jul 17 13:56:47 2010
@@ -24,8 +24,8 @@ under the License.
<faq id="build">
<question>How to build a Maven project with Maven Ant Tasks?</question>
<answer>
- <p>See the <a href="examples/mvn.html">examples page</a> for the mvn task for information about building
- a maven project from ant. </p>
+ <p>See the <a href="examples/mvn.html">examples page</a> for the mvn task for information about building
+ a Maven project from Ant.</p>
</answer>
</faq>
</part>