You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by ar...@apache.org on 2006/08/01 05:27:52 UTC

svn commit: r427424 - in /maven/plugins/trunk/maven-antrun-plugin: ./ src/site/ src/site/apt/ src/site/apt/examples/ src/site/fml/

Author: aramirez
Date: Mon Jul 31 20:27:51 2006
New Revision: 427424

URL: http://svn.apache.org/viewvc?rev=427424&view=rev
Log:
PR: MANTRUN-55
Submitted by: Franz Allan See
Reviewed By: Allan Ramirez

Added docck compliant docs

Added:
    maven/plugins/trunk/maven-antrun-plugin/src/site/apt/examples/
    maven/plugins/trunk/maven-antrun-plugin/src/site/apt/examples/classpaths.apt
    maven/plugins/trunk/maven-antrun-plugin/src/site/apt/index.apt
    maven/plugins/trunk/maven-antrun-plugin/src/site/fml/
    maven/plugins/trunk/maven-antrun-plugin/src/site/fml/faq.fml
Modified:
    maven/plugins/trunk/maven-antrun-plugin/pom.xml
    maven/plugins/trunk/maven-antrun-plugin/src/site/apt/classpaths.apt
    maven/plugins/trunk/maven-antrun-plugin/src/site/apt/introduction.apt
    maven/plugins/trunk/maven-antrun-plugin/src/site/apt/usage.apt
    maven/plugins/trunk/maven-antrun-plugin/src/site/site.xml

Modified: maven/plugins/trunk/maven-antrun-plugin/pom.xml
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-antrun-plugin/pom.xml?rev=427424&r1=427423&r2=427424&view=diff
==============================================================================
--- maven/plugins/trunk/maven-antrun-plugin/pom.xml (original)
+++ maven/plugins/trunk/maven-antrun-plugin/pom.xml Mon Jul 31 20:27:51 2006
@@ -97,4 +97,22 @@
       <version>1.6.5</version>
     </dependency>
   </dependencies>
+  <reporting>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-plugin-plugin</artifactId>
+        <version>2.2-SNAPSHOT</version>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jxr-plugin</artifactId>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-javadoc-plugin</artifactId>
+      </plugin>
+    </plugins>
+  </reporting>
 </project>
+

Modified: maven/plugins/trunk/maven-antrun-plugin/src/site/apt/classpaths.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-antrun-plugin/src/site/apt/classpaths.apt?rev=427424&r1=427423&r2=427424&view=diff
==============================================================================
--- maven/plugins/trunk/maven-antrun-plugin/src/site/apt/classpaths.apt (original)
+++ maven/plugins/trunk/maven-antrun-plugin/src/site/apt/classpaths.apt Mon Jul 31 20:27:51 2006
@@ -1,140 +0,0 @@
- ----
-Using the classpaths
- ----
-Carlos Sanchez
- ----
-11 January 2006
- ----
-
-Referencing the maven classpaths
-
- You can use these classpath references:
-  
-  * <<<maven.dependency.classpath>>> (deprecated, equal to <<<maven.compile.classpath>>>)
-
-  * <<<maven.compile.classpath>>>
-
-  * <<<maven.runtime.classpath>>>
-
-  * <<<maven.test.classpath>>>
-
-  * <<<maven.plugin.classpath>>>
-  
-
-Using optional ant tasks
-
-------
-<project>
-  <modelVersion>4.0.0</modelVersion>
-  <artifactId>my-test-app</artifactId>
-  <groupId>my-test-group</groupId>
-  <version>1.0-SNAPSHOT</version>
-
-  <build>
-    <plugins>
-
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-antrun-plugin</artifactId>
-        <executions>
-          <execution>
-            <id>compile</id>
-            <phase>compile</phase>
-            <configuration>
-              <tasks>
-                <antlr target="calc.g" outputdirectory="target">
-                  <classpath refid="maven.plugin.classpath"/>
-                </antlr>
-              </tasks>
-            </configuration>
-            <goals>
-              <goal>run</goal>
-            </goals>
-          </execution>
-        </executions>
-        <dependencies>
-          <dependency>
-            <groupId>ant</groupId>
-            <artifactId>ant-antlr</artifactId>
-            <version>1.6.5</version>
-          </dependency>
-          <dependency>
-            <groupId>antlr</groupId>
-            <artifactId>antlrall</artifactId>
-            <version>2.7.4</version>
-          </dependency>
-        </dependencies>
-      </plugin>
-
-    </plugins>
-  </build>
-</project>
-------
-
- or alternatively, using an external build.xml
- (note the <<<inheritRefs>>> property so the classpath references are passed to the build.xml)
-
-------
-<project>
-  <modelVersion>4.0.0</modelVersion>
-  <artifactId>my-test-app</artifactId>
-  <groupId>my-test-group</groupId>
-  <version>1.0-SNAPSHOT</version>
-
-  <build>
-    <plugins>
-
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-antrun-plugin</artifactId>
-        <executions>
-          <execution>
-            <id>compile</id>
-            <phase>compile</phase>
-            <configuration>
-              <tasks>
-                <ant antfile="${basedir}/build.xml" inheritRefs="true">
-                  <target name="test"/>
-                </ant>
-              </tasks>
-            </configuration>
-            <goals>
-              <goal>run</goal>
-            </goals>
-          </execution>
-        </executions>
-        <dependencies>
-          <dependency>
-            <groupId>ant</groupId>
-            <artifactId>ant-antlr</artifactId>
-            <version>1.6.5</version>
-          </dependency>
-          <dependency>
-            <groupId>antlr</groupId>
-            <artifactId>antlrall</artifactId>
-            <version>2.7.4</version>
-          </dependency>
-        </dependencies>
-      </plugin>
-
-    </plugins>
-  </build>
-</project>
-------
-
- The build.xml:
-
-------
-<?xml version="1.0"?>
-<project name="test6">
-
-    <target name="test">
-
-        <antlr target="calc.g" outputdirectory="target">
-            <classpath refid="maven.plugin.classpath"/>
-        </antlr>
-
-    </target>
-
-</project>
-------

Added: maven/plugins/trunk/maven-antrun-plugin/src/site/apt/examples/classpaths.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-antrun-plugin/src/site/apt/examples/classpaths.apt?rev=427424&view=auto
==============================================================================
--- maven/plugins/trunk/maven-antrun-plugin/src/site/apt/examples/classpaths.apt (added)
+++ maven/plugins/trunk/maven-antrun-plugin/src/site/apt/examples/classpaths.apt Mon Jul 31 20:27:51 2006
@@ -0,0 +1,160 @@
+ ------
+ Using the classpaths
+ ------
+ Carlos Sanchez, Franz Allan Valencia See
+ ------
+ 27 July 2006
+ ------
+
+~~ Copyright 2006 The Apache Software Foundation.
+~~
+~~ Licensed under the Apache License, Version 2.0 (the "License");
+~~ you may not use this file except in compliance with the License.
+~~ You may obtain a copy of the License at
+~~
+~~      http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing, software
+~~ distributed under the License is distributed on an "AS IS" BASIS,
+~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+~~ See the License for the specific language governing permissions and
+~~ limitations under the License.
+
+~~ NOTE: For help with the syntax of this file, see:
+~~ http://maven.apache.org/guides/mini/guide-apt-format.html
+
+Referencing the Maven Classpaths
+
+ You can use these classpath references:
+  
+  * <<<maven.dependency.classpath>>> (deprecated, equal to <<<maven.compile.classpath>>>)
+
+  * <<<maven.compile.classpath>>>
+
+  * <<<maven.runtime.classpath>>>
+
+  * <<<maven.test.classpath>>>
+
+  * <<<maven.plugin.classpath>>>
+  
+
+ For example, in using optional ant tasks, we can set our <<<target>>>'s 
+ classpath to the maven plugin's classpath, and it's output directory to 
+ "target".
+
+------
+<project>
+  <modelVersion>4.0.0</modelVersion>
+  <artifactId>my-test-app</artifactId>
+  <groupId>my-test-group</groupId>
+  <version>1.0-SNAPSHOT</version>
+
+  <build>
+    <plugins>
+
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-antrun-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>compile</id>
+            <phase>compile</phase>
+            <configuration>
+              <tasks>
+                <antlr target="calc.g" outputdirectory="target">
+                  <classpath refid="maven.plugin.classpath"/>
+                </antlr>
+              </tasks>
+            </configuration>
+            <goals>
+              <goal>run</goal>
+            </goals>
+          </execution>
+        </executions>
+        <dependencies>
+          <dependency>
+            <groupId>ant</groupId>
+            <artifactId>ant-antlr</artifactId>
+            <version>1.6.5</version>
+          </dependency>
+          <dependency>
+            <groupId>antlr</groupId>
+            <artifactId>antlrall</artifactId>
+            <version>2.7.4</version>
+          </dependency>
+        </dependencies>
+      </plugin>
+
+    </plugins>
+  </build>
+</project>
+------
+
+ or alternatively, we can use an external <<<build.xml>>> (<note the 
+ <<<inheritRefs>>> property so the classpath references are passed to the 
+ <<<build.xml>>>>)
+
+------
+<project>
+  <modelVersion>4.0.0</modelVersion>
+  <artifactId>my-test-app</artifactId>
+  <groupId>my-test-group</groupId>
+  <version>1.0-SNAPSHOT</version>
+
+  <build>
+    <plugins>
+
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-antrun-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>compile</id>
+            <phase>compile</phase>
+            <configuration>
+              <tasks>
+                <ant antfile="${basedir}/build.xml" inheritRefs="true">
+                  <target name="test"/>
+                </ant>
+              </tasks>
+            </configuration>
+            <goals>
+              <goal>run</goal>
+            </goals>
+          </execution>
+        </executions>
+        <dependencies>
+          <dependency>
+            <groupId>ant</groupId>
+            <artifactId>ant-antlr</artifactId>
+            <version>1.6.5</version>
+          </dependency>
+          <dependency>
+            <groupId>antlr</groupId>
+            <artifactId>antlrall</artifactId>
+            <version>2.7.4</version>
+          </dependency>
+        </dependencies>
+      </plugin>
+
+    </plugins>
+  </build>
+</project>
+------
+
+ The <<<build.xml>>>:
+
+------
+<?xml version="1.0"?>
+<project name="test6">
+
+    <target name="test">
+
+        <antlr target="calc.g" outputdirectory="target">
+            <classpath refid="maven.plugin.classpath"/>
+        </antlr>
+
+    </target>
+
+</project>
+------

Added: maven/plugins/trunk/maven-antrun-plugin/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-antrun-plugin/src/site/apt/index.apt?rev=427424&view=auto
==============================================================================
--- maven/plugins/trunk/maven-antrun-plugin/src/site/apt/index.apt (added)
+++ maven/plugins/trunk/maven-antrun-plugin/src/site/apt/index.apt Mon Jul 31 20:27:51 2006
@@ -0,0 +1,57 @@
+ ------
+ Introduction
+ ------
+ Kenney Westerhof, Franz Allan Valencia See
+ ------
+ 26 July 2006
+ ------
+
+~~ Copyright 2006 The Apache Software Foundation.
+~~
+~~ Licensed under the Apache License, Version 2.0 (the "License");
+~~ you may not use this file except in compliance with the License.
+~~ You may obtain a copy of the License at
+~~
+~~      http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing, software
+~~ distributed under the License is distributed on an "AS IS" BASIS,
+~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+~~ See the License for the specific language governing permissions and
+~~ limitations under the License.
+
+~~ NOTE: For help with the syntax of this file, see:
+~~ http://maven.apache.org/guides/mini/guide-apt-format.html
+
+Maven AntRun Plugin
+
+  This plugin provides the ability to run Ant tasks from within Maven2. You can 
+  even embed your ant scripts in the POM!
+
+  It is <not> the intention of this plugin to provide a means of polluting the 
+  POM, so it's encouraged to move all your Ant tasks to a <<<build.xml>>> file 
+  and just call it from the POM using Ant's 
+  {{{http://ant.apache.org/manual/CoreTasks/ant.html}\<ant/\> task}}.
+
+  One of the main purpose of this plugin is to facilitate the migration from Ant
+  based projects to Maven 2. Some projects may not currently unable to migrate 
+  because they depend on custom build functionality that Maven2 doesn't provide 
+  by default.
+      
+* Goals Overview
+
+  General Information about the goals.
+
+  * {{{run-mojo.html}antrun:run}} runs ant tasks for maven2.
+
+* Usage
+
+  Instructions on how to use the Maven AntRun Plugin can be found 
+  {{{usage.html}here}}.
+
+* Examples
+
+  To provide you with better understanding on some usages of the Maven AntRun 
+  Plugin, you can take a look into the following examples:
+
+  * {{{examples/classpaths.html}Referencing the Maven Classpaths}}

Modified: maven/plugins/trunk/maven-antrun-plugin/src/site/apt/introduction.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-antrun-plugin/src/site/apt/introduction.apt?rev=427424&r1=427423&r2=427424&view=diff
==============================================================================
--- maven/plugins/trunk/maven-antrun-plugin/src/site/apt/introduction.apt (original)
+++ maven/plugins/trunk/maven-antrun-plugin/src/site/apt/introduction.apt Mon Jul 31 20:27:51 2006
@@ -1,27 +0,0 @@
- -----
-Introduction
- -----
-Kenney Westerhof
- -----
-10 August 2005
- -----
-
-Introduction
-
-  This plugin provides the ability to run Ant tasks from
-  within Maven2. You can even embed your ant scripts in the POM!
-
-  It is <not> the intention of this plugin to provide a means
-  of polluting the POM, so it's encouraged to move all your
-  Ant tasks to a build.xml file and just call it from the POM
-  using Ant's {{{http://ant.apache.org/manual/CoreTasks/ant.html}\<ant/\> task}}.
-
-  One of the main goals of this plugin is to ease the migration from 
-  Ant based projects to Maven 2. A lot of projects are currently unable
-  to migrate simply because they depend on some custom build functionality
-  that Maven2 doesn't provide yet.
-      
-  Even with plugins widely available there will always be simple, small
-  tasks that can be done using one or two lines of Ant script (like
-  deploying an EAR), until ofcourse a plugin comes available that does
-  the job.

Modified: maven/plugins/trunk/maven-antrun-plugin/src/site/apt/usage.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-antrun-plugin/src/site/apt/usage.apt?rev=427424&r1=427423&r2=427424&view=diff
==============================================================================
--- maven/plugins/trunk/maven-antrun-plugin/src/site/apt/usage.apt (original)
+++ maven/plugins/trunk/maven-antrun-plugin/src/site/apt/usage.apt Mon Jul 31 20:27:51 2006
@@ -1,30 +1,50 @@
- ----
-Usage
- ----
-Kenney Westerhof
- ----
-10 August 2005
- ----
+ ------
+ Usage
+ ------
+ Kenney Westerhof, Franz Allan Valencia See
+ ------
+ 27 July 2006
+ ------
+
+~~ Copyright 2006 The Apache Software Foundation.
+~~
+~~ Licensed under the Apache License, Version 2.0 (the "License");
+~~ you may not use this file except in compliance with the License.
+~~ You may obtain a copy of the License at
+~~
+~~      http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing, software
+~~ distributed under the License is distributed on an "AS IS" BASIS,
+~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+~~ See the License for the specific language governing permissions and
+~~ limitations under the License.
+
+~~ NOTE: For help with the syntax of this file, see:
+~~ http://maven.apache.org/guides/mini/guide-apt-format.html
 
 Usage
 
-  For those of you unfamiliar with configuring a plugin see the example below:
+* Run
+
+  The maven-antrun-plugin has only one goal, <<<run>>>. 
+  
+  This allows maven 2 to run ant tasks. To do so, there must be an existing 
+  project and the maven-antrun-plugin must have its <<<\<tasks\>>>> tag 
+  configured (although it would still execute without the <<<\<tasks\>>>> tag, 
+  it would not do anything). Below is the template for the 
+  <<<maven-antrun-plugin>>>'s <<<pom.xml>>>.
 
 ------
 <project>
-  <modelVersion>4.0.0</modelVersion>
-  <artifactId>my-test-app</artifactId>
-  <groupId>my-test-group</groupId>
-  <version>1.0-SNAPSHOT</version>
-
+  [...]
   <build>
     <plugins>
-
       <plugin>
         <artifactId>maven-antrun-plugin</artifactId>
         <executions>
           <execution>
-            <phase>generate-sources</phase>
+            <phase> <!-- a lifecycle phase --> </phase>
             <configuration>
               <tasks>
 
@@ -42,21 +62,18 @@
           </execution>
         </executions>
       </plugin>
-
     </plugins>
   </build>
+  [...]
 </project>
 ------
 
-  The example above illustrates how to bind an ant script to a
-  lifecycle phase. You can add a script to each lifecycle phase,
-  by duplicating the <<<\<execution/\>>>> section and specifying
-  a new phase.
-
+  Moreover, you can add a script to each lifecycle phase, by duplicating the 
+  <<<\<execution/\>>>> section and specifying a new phase.
   
   Below you can see how to indicate that ant has generated some more java
   source that needs to be included in the compilation phase. Note that the
-  compile phase follows the generate-sources phase in the lifecycle.
+  compile phase follows the <<<generate-sources>>> phase in the lifecycle.
 
 ------
 <project>
@@ -98,12 +115,113 @@
 </project>
 ------
 
-  Of course, you can put whatever folder you prefer. The folders in the example above are
-  handy because they are deleted when you "clean" since they are in the build directory
-  (which is, by default, "target"). 
-
-  <<<\<sourceRoot/\>>>> adds a single folder to the
-  list of folders that get compiled with the program source code (compile).
+  Of course, you can put whatever folder you prefer. The folders in the example 
+  above arehandy because they are deleted when you <<<clean>>> since they are in
+  the build directory (which is, by default, "target"). 
+
+  <<<\<sourceRoot/\>>>> adds a single folder to the list of folders that get 
+  compiled with the program source code (<<<compile>>>).
+
+  <<<\<testSourceRoot/\>>>> adds a single folder to the list of folders that get
+  compiled with the test source code (<<<test-compile>>>).
+
+* Ant Expressions to Maven Expressions Mapping
+ 
+  Some Ant expressions have their respective counterparts in Maven. Thus, one
+  can simply invoke the corresponding maven expression instead of using 
+  maven-antrun-plugin to avoid the unneccessary overhead.
+
+*-----------------------------------+-----------------------------------+
+| <<Ant Expression>>                | <<Maven Expression>>              |
+*-----------------------------------------------------------------------+
+| Built-in Tasks                                                        |
+*-----------------------------------+-----------------------------------+
+| <<<Ant>>>                         | {{{../maven-antrun-plugin/}<<<maven-antrun-plugin>>>}}               |
+*-----------------------------------+-----------------------------------+
+| <<<AntCall>>>                     | {{{../maven-antrun-plugin/}<<<maven-antrun-plugin>>>}}               |
+*-----------------------------------+-----------------------------------+
+| <<<Available>>>                   | {{{http://maven.apache.org/guides/introduction/introduction-to-profiles.html}<<<profiles>>>}}                         |
+*-----------------------------------+-----------------------------------+
+| <<<BUnzip2>>>                     | {{{../maven-assembly-plugin/}<<<maven-assembly-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<BZip2>>>                       | {{{../maven-assembly-plugin/}<<<maven-assembly-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<Chmod>>>                       | {{{../maven-assembly-plugin/}<<<maven-assembly-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<Condition>>>                   | {{{http://maven.apache.org/guides/introduction/introduction-to-profiles.html}<<<profiles>>>}}                         |
+*-----------------------------------+-----------------------------------+
+| <<<Copy>>>                        | {{{../maven-resources-plugin/}<<<maven-resources-plugin>>>}}            |
+*-----------------------------------+-----------------------------------+
+| <<<Dependset>>>                   | {{{../maven-dependencies-plugin/}<<<maven-dependencies-plugin>>>}}         |
+*-----------------------------------+-----------------------------------+
+| <<<Ear>>>                         | {{{../maven-ear-plugin/}<<<maven-ear-plugin>>>}}                  |
+*-----------------------------------+-----------------------------------+
+| <<<Filter>>>                      | {{{../maven-resources-plugin/}<<<maven-resources-plugin>>>}}            |
+|                                   | <Note: Filter uses the @...@ token while maven-resources-plugin uses the $\{...\} token> |
+*-----------------------------------+-----------------------------------+
+| <<<FixCRLF>>>                     | {{{../maven-resources-plugin/}<<<maven-resources-plugin>>>}}            |
+*-----------------------------------+-----------------------------------+
+| <<<GenKey>>>                      | {{{../maven-jar-plugin/}<<<maven-jar-plugin>>>}}                  |
+*-----------------------------------+-----------------------------------+
+| <<<GUnzip>>>                      | {{{../maven-assembly-plugin/}<<<maven-assembly-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<GZip>>>                        | {{{../maven-assembly-plugin/}<<<maven-assembly-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<Jar>>>                         | {{{../maven-jar-plugin/}<<<maven-jar-plugin>>>}}                  |
+*-----------------------------------+-----------------------------------+
+| <<<Javac>>>                       | {{{../maven-compiler-plugin/}<<<maven-compiler-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<Javadoc/Javadoc2>>>            | {{{../maven-javadoc-plugin/}<<<maven-javadoc-plugin>>>}}               |
+*-----------------------------------+-----------------------------------+
+| <<<LoadProperties>>>              | {{{../maven-resources-plugin/}<<<maven-resources-plugin>>>}}            |
+*-----------------------------------+-----------------------------------+
+| <<<Manifest>>>                    | {{{../maven-jar-plugin/}<<<maven-jar-plugin>>>}}                  |
+*-----------------------------------+-----------------------------------+
+| <<<Property>>>                    | {{{../maven-resources-plugin/}<<<maven-resources-plugin>>>}}            |
+*-----------------------------------+-----------------------------------+
+| <<<Replace>>>                     | {{{../maven-resources-plugin/}<<<maven-resources-plugin>>>}}            |
+|                                   | <Note: Replace can specify its token while maven-resources-plugin uses the $\{...\} token> |
+*-----------------------------------+-----------------------------------+
+| <<<Tar>>>                         | {{{../maven-assembly-plugin/}<<<maven-assembly-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<Unjar>>>                       | {{{../maven-assembly-plugin/}<<<maven-assembly-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<Untar>>>                       | {{{../maven-assembly-plugin/}<<<maven-assembly-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<Unwar>>>                       | {{{../maven-assembly-plugin/}<<<maven-assembly-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<Unzip>>>                       | {{{../maven-assembly-plugin/}<<<maven-assembly-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<War>>>                         | {{{../maven-war-plugin/}<<<maven-war-plugin>>>}}                  |
+*-----------------------------------+-----------------------------------+
+| <<<Zip>>>                         | {{{../maven-assembly-plugin/}<<<maven-assembly-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+Optional Tasks                                                          |
+*-----------------------------------+-----------------------------------+
+| <<<Antlr>>>                       | {{{../maven-antlr-plugin/}<<<maven-antlr-plugin>>>}}                |
+*-----------------------------------+-----------------------------------+
+| <<<Depend>>>                      | {{{../maven-dependencies-plugin/}<<<maven-dependencies-plugin>>>}}         |
+*-----------------------------------+-----------------------------------+
+| <<<EJB Tasks>>>                   | {{{../maven-ejb-plugin/}<<<maven-ejb-plugin>>>}}                  |
+*-----------------------------------+-----------------------------------+
+| <<<FTP>>>                         | {{{../maven-deploy-plugin/}<<<maven-deploy-plugin>>>}}               |
+|                                   | <Note: maven-deploy-plugin can only deploy unto the FTP> |
+*-----------------------------------+-----------------------------------+
+| <<<JavaCC>>>                      | {{{../maven-compiler-plugin/}<<<maven-compiler-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<JJDoc>>>                       | {{{../maven-compiler-plugin/}<<<maven-compiler-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<JJTree>>>                      | {{{../maven-compiler-plugin/}<<<maven-compiler-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<JUnit>>>                       | {{{../maven-surefire-plugin/}<<<maven-surefire-plugin>>>}}             |
+*-----------------------------------+-----------------------------------+
+| <<<JUnitReport>>>                 | {{{../maven-surefire-report-plugin/}<<<maven-surefire-report-plugin>>>}}      |
+*-----------------------------------+-----------------------------------+
+| <<<ServerDeploy>>>                | {{{../maven-deploy-plugin/}<<<maven-deploy-plugin>>>}}               |
+*-----------------------------------+-----------------------------------+
+| <<<Setproxy>>>                    | {{{../maven-deploy-plugin/}<<<maven-deploy-plugin>>>}}               |
+*-----------------------------------+-----------------------------------+
+| <<<Translate>>>                   | {{{../maven-resources-plugin/}<<<maven-resources-plugin>>>}}            |
+|                                   | <Note: Translate can specify its own tokens and can have a different encoding scheme for reading and writing files. maven-resources-plugin however uses the $\{...\} annotation only and has only one encoding scheme for reading and writing> |
+*-----------------------------------+-----------------------------------+
 
-  <<<\<testSourceRoot/\>>>> adds a single folder to the
-  list of folders that get compiled with the test source code (test-compile).

Added: maven/plugins/trunk/maven-antrun-plugin/src/site/fml/faq.fml
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-antrun-plugin/src/site/fml/faq.fml?rev=427424&view=auto
==============================================================================
--- maven/plugins/trunk/maven-antrun-plugin/src/site/fml/faq.fml (added)
+++ maven/plugins/trunk/maven-antrun-plugin/src/site/fml/faq.fml Mon Jul 31 20:27:51 2006
@@ -0,0 +1,36 @@
+<?xml version="1.0"?>
+
+<!--
+  ~ Copyright 2006 The Apache Software Foundation.
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+<faqs id="FAQ" title="Frequently Asked Questions">
+ <part id="General">
+   <faq id="Why use antrun and not the ant program itself?">
+     <question>Why use antrun and not the ant program itself?</question>
+     <answer>
+       <p>Maven has certain benefits over Ant. And for your ant projects to take
+       advantage of these, you can use maven as your porject management tool and
+       use its maven-antrun-plugin to build your ant projects (<I>See 
+       <a href="http://maven.apache.org/start/maven-for-ant-users.html">
+       Maven for Ant Users</a> for a comparison between Maven and Ant</I>). </p>
+       <p>Furthermore, if you wish to migrate from ant to maven, you can use 
+       this plugin first, then gradually convert your ant expressions into their
+       corresponding maven expressions.</p>
+     </answer>
+   </faq>
+ </part>
+</faqs>
+

Modified: maven/plugins/trunk/maven-antrun-plugin/src/site/site.xml
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-antrun-plugin/src/site/site.xml?rev=427424&r1=427423&r2=427424&view=diff
==============================================================================
--- maven/plugins/trunk/maven-antrun-plugin/src/site/site.xml (original)
+++ maven/plugins/trunk/maven-antrun-plugin/src/site/site.xml Mon Jul 31 20:27:51 2006
@@ -1,27 +1,26 @@
 <?xml version="1.0"?>
 
 <!--
- | Copyright 2001-2005 The Apache Software Foundation.
- |
- | Licensed under the Apache License, Version 2.0 (the "License");
- | you may not use this file except in compliance with the License.
- | You may obtain a copy of the License at
- |
- |      http://www.apache.org/licenses/LICENSE-2.0
- |
- | Unless required by applicable law or agreed to in writing, software
- | distributed under the License is distributed on an "AS IS" BASIS,
- | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- | See the License for the specific language governing permissions and
- | limitations under the License.
- |
--->
+  ~ Copyright 2006 The Apache Software Foundation.
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
 
 <project name="Maven AntRun Plugin">
   <bannerLeft>
     <name>Maven AntRun Plugin</name>
     <src>http://maven.apache.org/images/apache-maven-project.png</src>
-    <href>http://maven.apache.org/maven2/</href>
+    <href>http://maven.apache.org</href>
   </bannerLeft>
   <bannerRight>
     <src>http://maven.apache.org/images/maven-small.gif</src>
@@ -33,11 +32,17 @@
     </links>
 
     <menu name="Overview">
-      <item name="Introduction" href="introduction.html"/>
+      <item name="Introduction" href="index.html"/>
+	  <item name="Goals" href="plugin-info.html"/>
       <item name="Usage" href="usage.html"/>
-      <item name="Using classpaths" href="classpaths.html"/>
+	  <item name="FAQ" href="faq.html"/>
+    </menu>
+	
+	<menu name="Examples">
+      <item name="Referencing the Maven Classpaths" href="examples/classpaths.html"/>
     </menu>
 
     ${reports}
   </body>
 </project>
+