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> +