You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-commits@maven.apache.org by sv...@apache.org on 2020/01/05 17:21:09 UTC
svn commit: r1872355 [3/6] - in /maven/website/content: ./
apache-resource-bundles/ archives/maven-2.x/ background/ developers/
developers/conventions/ developers/release/ developers/website/ docs/
docs/2.0.1/ docs/2.0.10/ docs/2.0.11/ docs/2.0.2/ docs...
Added: maven/website/content/faq-unoffical.html
==============================================================================
--- maven/website/content/faq-unoffical.html (added)
+++ maven/website/content/faq-unoffical.html Sun Jan 5 17:21:06 2020
@@ -0,0 +1,1807 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.9.1 from content/markdown/faq-unoffical.md at 2020-01-05
+ | Rendered using Apache Maven Fluido Skin 1.8
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <meta name="generator" content="Apache Maven Doxia Site Renderer 1.9.1" />
+ <title>Maven – </title>
+ <link rel="stylesheet" href="./css/apache-maven-fluido-1.8.min.css" />
+ <link rel="stylesheet" href="./css/site.css" />
+ <link rel="stylesheet" href="./css/print.css" media="print" />
+ <script src="./js/apache-maven-fluido-1.8.min.js"></script>
+ <!-- Google Analytics -->
+ <script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+ ga('create', 'UA-140879-1', 'auto');
+ ga('send', 'pageview');
+ ga('set', 'anonymizeIp', true);
+ ga('set', 'forceSSL', true);
+ </script>
+ </head>
+ <body class="topBarDisabled">
+ <div class="container-fluid">
+ <header>
+ <div id="banner">
+ <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site"/></a></div>
+ <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt=""/></a></div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+ <li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
+ <li class=""><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li>
+ <li class="active "> <a href="https://github.com/apache/maven-site/tree/master/content/markdown/faq-unoffical.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2020-01-05</li>
+ <li class="pull-right"><span class="divider">|</span>
+<a href="scm.html" title="Get Sources">Get Sources</a></li>
+ <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li>
+ </ul>
+ </div>
+ </header>
+ <div class="row-fluid">
+ <header id="leftColumn" class="span2">
+ <nav class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li><a href="index.html" title="Welcome"><span class="none"></span>Welcome</a></li>
+ <li><a href="https://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li class="nav-header">About Maven</li>
+ <li><a href="what-is-maven.html" title="What is Maven?"><span class="none"></span>What is Maven?</a></li>
+ <li><a href="maven-features.html" title="Features"><span class="none"></span>Features</a></li>
+ <li><a href="download.html" title="Download"><span class="none"></span>Download</a></li>
+ <li><a href="users/index.html" title="Use"><span class="icon-chevron-right"></span>Use</a></li>
+ <li><a href="docs/history.html" title="Release Notes"><span class="none"></span>Release Notes</a></li>
+ <li class="nav-header">Documentation</li>
+ <li><a href="plugins/index.html" title="Maven Plugins"><span class="none"></span>Maven Plugins</a></li>
+ <li><a href="guides/index.html" title="Index (category)"><span class="none"></span>Index (category)</a></li>
+ <li><a href="users/index.html" title="User Centre"><span class="icon-chevron-right"></span>User Centre</a></li>
+ <li><a href="plugin-developers/index.html" title="Plugin Developer Centre"><span class="icon-chevron-right"></span>Plugin Developer Centre</a></li>
+ <li><a href="repository/index.html" title="Maven Central Repository"><span class="icon-chevron-right"></span>Maven Central Repository</a></li>
+ <li><a href="developers/index.html" title="Maven Developer Centre"><span class="icon-chevron-right"></span>Maven Developer Centre</a></li>
+ <li><a href="articles.html" title="Books and Resources"><span class="none"></span>Books and Resources</a></li>
+ <li><a href="security.html" title="Security"><span class="none"></span>Security</a></li>
+ <li class="nav-header">Community</li>
+ <li><a href="community.html" title="Community Overview"><span class="none"></span>Community Overview</a></li>
+ <li><a href="project-roles.html" title="Project Roles"><span class="none"></span>Project Roles</a></li>
+ <li><a href="guides/development/guide-helping.html" title="How to Contribute"><span class="none"></span>How to Contribute</a></li>
+ <li><a href="users/getting-help.html" title="Getting Help"><span class="none"></span>Getting Help</a></li>
+ <li><a href="issue-management.html" title="Issue Management"><span class="none"></span>Issue Management</a></li>
+ <li><a href="scm.html" title="Getting Maven Source"><span class="none"></span>Getting Maven Source</a></li>
+ <li><a href="team.html" title="The Maven Team"><span class="none"></span>The Maven Team</a></li>
+ <li class="nav-header">Project Documentation</li>
+ <li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
+ <li class="nav-header">Maven Projects</li>
+ <li><a href="archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li>
+ <li><a href="resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li>
+ <li><a href="doxia/index.html" title="Doxia"><span class="none"></span>Doxia</a></li>
+ <li><a href="jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li>
+ <li><a href="ref/current" title="Maven"><span class="none"></span>Maven</a></li>
+ <li><a href="pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li>
+ <li><a href="plugins/index.html" title="Plugins"><span class="none"></span>Plugins</a></li>
+ <li><a href="plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li>
+ <li><a href="plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li>
+ <li><a href="apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li>
+ <li><a href="scm/index.html" title="SCM"><span class="none"></span>SCM</a></li>
+ <li><a href="shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li>
+ <li><a href="skins/index.html" title="Skins"><span class="none"></span>Skins</a></li>
+ <li><a href="surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li>
+ <li><a href="wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li>
+ <li class="nav-header">ASF</li>
+ <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li>
+ <li><a href="https://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li>
+ <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li>
+ <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li>
+ </ul>
+ </nav>
+ <div class="well sidebar-nav">
+<form id="search-form" action="https://www.google.com/search" method="get" >
+ <input value="https://maven.apache.org" name="sitesearch" type="hidden"/>
+ <input class="search-query" name="q" id="query" type="text" />
+</form>
+<script>asyncJs( 'https://cse.google.com/brand?form=search-form' )</script>
+ <hr />
+ <div id="poweredBy">
+ <div class="clear"></div>
+ <div id="twitter">
+ <a href="https://twitter.com/ASFMavenProject" class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a>
+ <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script>
+ </div>
+ <div class="clear"></div>
+ <div class="clear"></div>
+<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
+ </div>
+ </div>
+ </header>
+ <main id="bodyColumn" class="span10" >
+<p><i>NOTE:</i> <i>This page contains drafts of user contributed FAQ entries. The content you see here might not be fully fool-proof or might not comply with the best practices promoted by Maven. What is only guaranteed is that they have worked once for some members. It is best to treat these items as “works in progress” until they have been reviewed and promoted to the main Maven documentation site.</i></p>
+<p>Please follow the format that is being used because it will help in our automated extraction of material which can then be incorporated into the main site.</p>
+<p>This page serves as a collection of questions <i>with</i> answers. If you have a frequently asked question that doesn’t yet have an answer, please list that question on [the other page](FAQs].</p>
+<h1>Answered Questions (Index)</h1><section><section>
+<h3><a name="Reports_.26_Site_Docs"></a>Reports & Site Docs</h3>
+<p>[How do I merge a list of configuration items in a parent POM with those in a child POM?](#How do I merge a list of configuration items in a parent POM with those in a child POM?) [Why do I not get an index.html page generated for my project website?](#Why do I not get an index.html page generated for my project website?) [How do I include/exclude the other modules in the navigation menu in the parent site?](#How do I include/exclude the other modules in the navigation menu in the parent site?) [How do I create a report that does not require Doxia’s Sink interface?](#How do I create a report that does not require Doxia’s Sink interface?) [How do I generate Maven plug-in sites, with pages that include an overview of the goals and parameters for each plug-in?](#How do I generate Maven plug-in sites, with pages that include an overview of the goals and parameters for each plug-in?) [Is there a site.xml DTD?](#Is there a site.xml DTD?) [How do I integrate static (x)html
into a Maven site?](#How do I integrate static (x)html into a Maven site?) [Where do I configure report plug-ins, like javadoc?](#Where do I configure report plug-ins, like javadoc?) [Is there a way to get Maven to report the number of compile errors found?](#Is there a way to get Maven to report the number of compile errors found?) [How do I convert my < reports > from Maven 1 to Maven 2?](#How do I convert my < reports > from Maven 1 to Maven 2?) (#Handle special characters in site) [How do I add a description to the welcome page of the generated site when I execute mvn site?](#How do I add a description to the welcome page of the generated site when I execute mvn site?] [Which part in pom.xml the javadoc plugin should be configured?](#Which part in pom.xml the javadoc plugin should be configured?]</p></section><section>
+<h3><a name="Eclipse"></a>Eclipse</h3>
+<p>[How do I specify which output folders the Eclipse plugin puts into the .classpath file?](#How do I specify which output folders the Eclipse plugin puts into the .classpath file?] [Where can I get the Maven 2 plugin for Eclipse?](#Where can I get the Maven 2 plugin for Eclipse?] [I issued- mvn -Declipse.downloadSources=true eclipse eclipse goal. It created .classpath and .project for both modules, and in my local repository it downloaded sources Ho do I access them in eclipse?](#I issued- mvn -Declipse.downloadSources=true eclipse eclipse goal. It created .classpath and .project for both modules, and in my local repository it downloaded sources Ho do I access them in eclipse?] [Is it possible that if I do mvn eclipse eclipse goal that my project would get disconnected from the subversion repository?](#Is it possible that if I do mvn eclipse eclipse goal that my project would get disconnected from the subversion repository?] [Does it matter if the project’s directory name i
s not the same as the artifactId?](#Does it matter if the project’s directory name is not the same as the artifactId?]</p></section><section>
+<h3><a name="Plugins"></a>Plugins</h3>
+<p>[How do I resolve the " < plugin name > does not exist or no valid version " error?](#no-valid-version] [How do I list available plugins?](#How do I list available plugins?] [How do I get a plug-in’s dependencies from a Mojo?](#How do I get a plug-in’s dependencies from a Mojo?] [How do I locate a required plug-in?](#How do I locate a required plug-in?] [How do I determine what version of a plugin I am using?](#How do I determine what version of a plugin I am using?] [How do I use SNAPSHOT versions of plug-ins?](#How do I use SNAPSHOT versions of plug-ins?] [Is there a property file for plug-in configuration in Maven 2.0?](#Is there a property file for plug-in configuration in Maven 2.0?] [I’ve just created a maven plugin. Is there a sample plugin integration test I can use?](#I’ve just created a maven plugin. Is there a sample plugin integration test I can use?] [The snapshot version of the plugin is not updated in the snapshot repo, W
hat should I do to update my copy of the plugin?](#The snapshot version of the plugin is not updated in the snapshot repo, What should I do to update my copy of the plugin?] [How to list all goals available for a certain plugin?](#How to list all goals available for a certain plugin?] [What does the ‘You cannot have two plugin executions with the same (or missing) elements’ message mean?](#What does the ‘You cannot have two plugin executions with the same (or missing) elements’ message mean?] [#How do I execute the assembly plugin with different configurations] [Where is the plugin-registry.xml?](#Where is the plugin-registry.xml?] [How do I know which phase a plug-in is associated with?](#How do I know which phase a plug-in is associated with?]</p></section><section>
+<h3><a name="POM"></a>POM</h3>
+<p>[#How do I install a file in my local repository along with a generic POM] [How do I install a file in my local repository along with my customized POM?](#How do I install a file in my local repository along with my customized POM?] [Does the v4.0.0 POM include a < versions/ > element?](#Does the v4.0.0 POM include a < versions/ > element?] [How do I read the version from the pom.xml and then using Java display the version on my application?](#How do I read the version from the pom.xml and then using Java display the version on my application?] [How do I determine which POM contains missing transitive dependency?](#How do I determine which POM contains missing transitive dependency?] [Does a POM inherit its resources?](#Does a POM inherit its resources?] [Is it possible to specify multiple(s) in a POM at a greater depth than 1 level?](#Is it possible to specify multiple(s) in a POM at a greater depth than 1 level?] [Is there a way to read and examine the contents of a
pom.xml file from inside an application?](#Is there a way to read and examine the contents of a pom.xml file from inside an application?] [Is there a way to use the current date in the POM?](#Is there a way to use the current date in the POM?] [Where are the Maven XSD schemas?](#Where are the Maven XSD schemas?] [Where can I find a complete list of properties available in the pom?](MavenPropertiesGuide]</p></section><section>
+<h3><a name="Dependencies"></a>Dependencies</h3>
+<p>[How do I implement “maven.jar.override” of Maven 1 with Maven 2?](#How do I implement maven.jar.override of Maven 1 with Maven 2] [Why there are no dependency properties in Maven 2?](#Why there are no dependency properties in Maven 2?] [How to make a war artifact as a dependency?](#How to make a war artifact as a dependency?] [Can I disable transitive dependencies?](#Can I disable transitive dependencies?] [Is there a preferred way to communicate dependencies in documentation?](#Is there a preferred way to communicate dependencies in documentation?] [Are there any recommendations on how to handle dependencies, which aren’t always required?](#Are there any recommendations on how to handle dependencies, which aren’t always required?] [How do I determine my project’s transitive dependencies, and if needed, exclude a particular transitive dependency?](#How do I determine my project’s transitive dependencies, and if needed, exclude a particu
lar transitive dependency?] [If two versions of the same dependency are at the same depth, how do you know or predict which version will be used?](#If two versions of the same dependency are at the same depth, how do you know or predict which version will be used?]</p></section><section>
+<h3><a name="Inheritance"></a>Inheritance</h3>
+<p>[How can I have a child project not inherit a goal (like install) from the parent?](#How can I have a child project not inherit a goal (like install) from the parent?] [What is Maven’s order of inheritance?](#What is Maven’s order of inheritance?] [How do I specify that all web modules will inherit the group’s common files from a parent web module?](#How do I specify that all web modules will inherit the group’s common files from a parent web module?]</p></section><section>
+<h3><a name="Repository"></a>Repository</h3>
+<p>[How do I prevent verification warnings with custom repositories?](#How do I prevent verification warnings with custom repositories?] [How do I access artifacts if Ibiblio is down?](#How do I access artifacts if Ibiblio is down?] [How do I specify my remote repo in Maven 2.0?](#How do I specify my remote repo in Maven 2.0?] [How do I install artifacts to a remote repository?](#How do I install artifacts to a remote repository?] [#Repository precedence] [#List of available maven 2 mirrors.] [How do I change the default remote repository?](#How do I change the default remote repository?] [How to remove the artifact in the local repository?](#How to remove the artifact in the local repository?] [What is the purpose of remote repository (other than ibilbilo)?](#What is the purpose of remote repository (other than ibilbilo)?]</p></section><section>
+<h3><a name="Errors"></a>Errors</h3>
+<p>[#Why do I get java.lang.NoClassDefFoundError: org/codehaus/classworlds/Launcher when I try to execute Maven?] [What does the “ERROR Cannot override read-only parameter < parameter_name>” message, when running mean?](#What does the “ERROR Cannot override read-only parameter < parameter_name>” message, when running mean?] [What does the FATAL ERROR with the message *‘Class org.apache.commons.logging.impl.Jdk14Logger does not implement Log’* when using the maven-checkstyle-plugin mean?](#What does the FATAL ERROR with the message <i>‘Class org.apache.commons.logging.impl.Jdk14Logger does not implement Log’</i> when using the maven-checkstyle-plugin mean?] [Unsupported Protocol Error when deploying a 3rd party jar. What should I do?](#Unsupported Protocol Error when deploying a 3rd party jar. What should I do?] [I have my web.xml in my customed directory layout for my webapp, but why am I getting the error “D
eployment descriptor < Path >\WEB-INF\web.xml does not exist”?](#I have my web.xml in my customed directory layout for my webapp, but why am I getting the error “Deployment descriptor < Path >\WEB-INF\web.xml does not exist”?] [How can I stop this “WARNING While downloading artifactId-artifactId-version This artifact has been relocated to groupId-artifactId-version”?](#How can I stop this “WARNING While downloading artifactId-artifactId-version This artifact has been relocated to groupId-artifactId-version”?] [Why do i get an ‘error downloading artifact’ message when building with Maven 2 under Fedora Core 4 and Java 1.4?](#Why do i get an ‘error downloading artifact’ message when building with Maven 2 under Fedora Core 4 and Java 1.4?]</p></section><section>
+<h3><a name="Supported_Features"></a>Supported Features</h3>
+<p>[Does Maven 2.x support pre/postGoals?](#Does Maven 2.x support pre/postGoals?] [How does maven 2 implement reproducibility?](#How does maven 2 implement reproducibility?]</p></section><section>
+<h3><a name="Maven_Comparisons"></a>Maven Comparisons</h3>
+<p>[What is the difference between Maven and Ivy?](#What is the difference between Maven and Ivy?]</p></section><section>
+<h3><a name="Ant"></a>Ant</h3>
+<p>[How can I use Ant tasks in Maven 2?](#How can I use Ant tasks in Maven 2?] [How do I run an ant task twice, against two different phases?](#How do I run an ant task twice, against two different phases?] [Can I define the antrun plug-in to be executed on demand?](#Can I define the antrun plug-in to be executed on demand?] [How do I generate sources with the antrun plug-in?](#How do I generate sources with the antrun plug-in?] [How do I setup the classpath of my antrun plugin to use the classpath from maven?](#How do I setup the classpath of my antrun plugin to use the classpath from maven?]</p></section><section>
+<h3><a name="Mojo"></a>Mojo</h3>
+<p>[How do I get the project’s sources from a Mojo?](#How do I get the project’s sources from a Mojo?] [How do I properly populate variables, when extending a mojo from another plugin?](#How do I properly populate variables, when extending a mojo from another plugin?] [How do I determine the stale resources in a Mojo to avoid reprocessing them?](#How do I determine the stale resources in a Mojo to avoid reprocessing them?] [How do I create a command line parameter (i.e., -Dname=value ) in my mojo?](#How do I create a command line parameter (i.e., -Dname=value ) in my mojo?] [What does aggregator mean in mojo?](#What does aggregator mean in mojo?] [What would it take for the MOJO one to get out of the sandbox?](#What would it take for the MOJO one to get out of the sandbox?] [How do I indicate array types in a MOJO configuration?](#How do I indicate array types in a MOJO configuration?]</p></section><section>
+<h3><a name="Deploy"></a>Deploy</h3>
+<p>[How do I deploy my binary during the deploy phase?](#How do I deploy my binary during the deploy phase?] [How do I invoke the ‘maven dist’ function from Maven 1.0, in Maven 2.0?](#How do I invoke the ‘maven dist’ function from Maven 1.0, in Maven 2.0?] [Is there a way to use the deploy phase to perform some tasks without maven trying to install the artifact to a maven repository?](#Is there a way to use the deploy phase to perform some tasks without maven trying to install the artifact to a maven repository?] [Is maven ‘deploy’ goal and actually copying of a dependency or artifact jar to remote repository same?](#Is maven ‘deploy’ goal and actually copying of a dependency or artifact jar to remote repository same?]</p></section><section>
+<h3><a name="Release"></a>Release</h3>
+<p>[#When I run mvn release:prepare, I get a build failure saying “Unable to tag SCM, File (…) already exists”. However, the tag does not exist. What is wrong?]</p></section><section>
+<h3><a name="Profiles"></a>Profiles</h3>
+<p>[Can a profile inherit the configuration of a “sibling” profile?](#Can a profile inherit the configuration of a “sibling” profile?]</p></section><section>
+<h3><a name="Testing"></a>Testing</h3>
+<p>[How do I prevent tests from running twice, after adding a configuration for the surefire plugin?](#How do I prevent tests from running twice, after adding a configuration for the surefire plugin?] [How do I skip unit tests when building a project?](#How do I skip unit tests when building a project?] [Is there a setting for testing, where I can add a directory to the classpath, which will allow the tests to access the files?](#Is there a setting for testing, where I can add a directory to the classpath, which will allow the tests to access the files?] [Why does Maven compile my test classes but don’t run them?](#Why does Maven compile my test classes but don’t run them?]</p></section><section>
+<h3><a name="Compile"></a>Compile</h3>
+<p>[How do I compile 1.3 java sources with a 1.4.x or 1.5.x JDK?](#How do I compile 1.3 java sources with a 1.4.x or 1.5.x JDK?] [#Building modules only when they have changed]</p></section><section>
+<h3><a name="Adding_or_Excluding"></a>Adding or Excluding</h3>
+<p>[Can I add a java source to my war package?](#Can I add a java source to my war package?] [How do I filter which classes should be put inside the packaged jar?](#How do I filter which classes should be put inside the packaged jar?] [Is it possible to exclude a package from the generated jar file?](#Is it possible to exclude a package from the generated jar file?] [How not to include all jar files from parent pom?](#How not to include all jar files from parent pom?] [How do I filter resources in the war?](#How do I filter resources in the war?] [How do I prevent including JARs in WEB-INF/lib? I need a “compile only” scope!](#How do I prevent including JARs in WEB-INF/lib? I need a “compile only” scope!]</p></section><section>
+<h3><a name="Changing_Locations"></a>Changing Locations</h3>
+<p>[How can I change the default location of the generated jar when I command “mvn package”?](#How can I change the default location of the generated jar when I command “mvn package”?] [Is there a way to specify a different output directory without having to edit the pom or configuration file each time I do a build?](#Is there a way to specify a different output directory without having to edit the pom or configuration file each time I do a build?] [How do I set the base directory for creating the packages created by assembly?](#How do I set the base directory for creating the packages created by assembly?] [Is it possible to create my own directory structure?](#Is it possible to create my own directory structure?]</p></section><section>
+<h3><a name="JDK"></a>JDK</h3>
+<p>[#I would like clarification on what version of the JDK is required for m2 – particularly with respect to creating Plugins.] [#i’m wondering what a “snapshot” actually is.] [How do I configure a project to use a specific version of a JDK?](#How do I configure a project to use a specific version of a JDK?]</p></section><section>
+<h3><a name="Other"></a>Other</h3>
+<p>[Maven doesn’t work, how do I get help?](#Maven doesn’t work, how do I get help?] [How do I get a list of archetypes?](#How do I get a list of archetypes?] [How do I add main class in a generated jar’s manifest?](#How do I add main class in a generated jar’s manifest?] [How do I run a build/package/deploy process without waiting for reports or unit tests, so that I can quickly deploy to an integration box?](#How do I run a build/package/deploy process without waiting for reports or unit tests, so that I can quickly deploy to an integration box?] [Where is the source code? I couldn’t seem to find a link anywhere on the Maven2 site.](#Where is the source code? I couldn’t seem to find a link anywhere on the Maven2 site.] [How do I configure the equivalent of maven.war.src of war plugin in Maven 2.0?](#How do I configure the equivalent of maven.war.src of war plugin in Maven 2.0?] [How do I add my generated sources to the compile path of Mave
n, when using modello?](#How do I add my generated sources to the compile path of Maven, when using modello?] [Where can I get offline documentation for Maven?](#Where can I get offline documentation for Maven?] [What is the purpose of displaying read-only, plug-in fields in user documentation, if they are not configurable in the project descriptor?](#What is the purpose of displaying read-only, plug-in fields in user documentation, if they are not configurable in the project descriptor?] [How can I disable the timestamp appended in my deployed artifact?](#How can I disable the timestamp appended in my deployed artifact?] [How to run a java program from M2?](#How to run a java program from M2?] [Where to find the source code for org.apache.maven.model package?](#Where to find the source code for org.apache.maven.model package?] [How can I reference windows or unix environment variables in my POM?](#How can I reference windows or unix environment variables in my POM?] [Where to get s
un.jdk-tools-jar-1.4.0 on MacOSX?](#Where to get sun.jdk-tools-jar-1.4.0 on MacOSX?] [How can I make the war plugin produces an exploded war instead of .war file?](#How can I make the war plugin produces an exploded war instead of .war file?] [Is there any variable to determine what version of an artifact was deployed after the deploy step runs?](#Is there any variable to determine what version of an artifact was deployed after the deploy step runs?] [How do I get the top line of a table to be “headers” for that column in APT?](#How do I get the top line of a table to be “headers” for that column in APT?] [What is the suggested way to download a remote file?](#What is the suggested way to download a remote file?] [How do I install the package generated by the assembly plugin to be installed in the local repository?](#How do I install the package generated by the assembly plugin to be installed in the local repository?] [Is it possible to use HashMap as co
nfigurable parameter in a plugin? How do I configure that in pom.xml?](#Is it possible to use HashMap as configurable parameter in a plugin? How do I configure that in pom.xml?] [Which plugins have StarTeam (SCM) support? How do they differ?](#Which plugins have StarTeam (SCM) support? How do they differ?] [How should I point a path for maven 2 to use a certain version of JDK when I have different versions of JDK installed on my PC and my JAVA_HOME already set?](#How should I point a path for maven 2 to use a certain version of JDK when I have different versions of JDK installed on my PC and my JAVA_HOME already set?] [Why does release prepare goal requires the project to be released be a snapshot? Is it possible to do a release prepare from a parent project? What about from a sub-project?](#Why does release prepare goal requires the project to be released be a snapshot? Is it possible to do a release prepare from a parent project? What about from a sub-project?] [How can I create a
n archetype with resources mapped to the class files directory?](#How can I create an archetype with resources mapped to the class files directory?] [What does (f) and (s) debug output mean?](#What does (f) and (s) debug output mean?] [How to resolve problems with jtaxxx.jar?](#How to resolve problems with jtaxxx.jar?] [How to make Continuum work in service mode when an Error 1067 is reported?](#How to make Continuum work in service mode when an Error 1067 is reported?] [Using xdoclet, how come “” does not work?](#Using xdoclet, how come “” does not work?] [I don’t have a domain name and I don’t want use my employer’s domain name. What should I name my plugin package?](#I don’t have a domain name and I don’t want use my employer’s domain name. What should I name my plugin package?] [pom.xml or settings.xml? What is the best practice configuration usage for these files?](#pom.xml or settings.xml? What is the best p
ractice configuration usage for these files?] [What is reactorProjects? executedProject?](#What is reactorProjects? executedProject?] [What is a Snapshot?](#What is a Snapshot?] [Whenever a file is modified in a maven project how is the SNAPSHOT jar updated in the remote repository?](#Whenever a file is modified in a maven project how is the SNAPSHOT jar updated in the remote repository?] [Does maven support automated build and test from non-Java applications?](#Does maven support automated build and test from non-Java applications?] [What would be the appropriate way to enable inheritance of classes in the test hierarchy across modules during the test-compile phase of a multi-pom project?](#What would be the appropriate way to enable inheritance of classes in the test hierarchy across modules during the test-compile phase of a multi-pom project?] [Is Julia Antonova/Tumlare out of the office?](#Is Julia Antonova/Tumlare out of the office?] [How to encrypt a secure password that incl
udes an Ampersand](#How to encrypt a secure password that includes an Ampersand]</p>
+<h1>Answered Questions</h1></section><section>
+<h3><a name="How_do_I_merge_a_list_of_configuration_items_in_a_parent_POM_with_those_in_a_child_POM.3F"></a>How do I merge a list of configuration items in a parent POM with those in a child POM?</h3>
+<p>Since plugin configurations are handled as XML DOM instances by the core, there is an ever-present struggle between when to merge child elements’ values with one another (when the child’s <source> overrides the parent’s, for example), and when you want to append new child elements to the existing list (as in the example above, or any time you have a list of items to aggregate during inheritance).</p>
+<p>We’ve solved this problem using an attribute, combine.children. You simply specify this attribute, with the value of append at the parent element where such aggregation should occur, and Maven will switch its merge behavior for that element’s children.</p>
+<p>NOTE: I fixed this behavior in Maven’s trunk; previously, it had been putting the parent POM’s sub-elements AFTER those of the child. This is inconsistent with other inheritance functions, so I’ve reversed the ordering to truly append the child’s elements.</p>
+<p>So, to recap:</p>
+<p>parent:</p>
+
+<div>
+<div>
+<pre class="source"><configuration>
+ <items>
+ <item>one</item>
+ <item>two</item>
+ </items>
+</configuration>
+</pre></div></div>
+
+<p>child:</p>
+
+<div>
+<div>
+<pre class="source"><configuration>
+ <items combine.children="append">
+ <item>three</item>
+ </items>
+</configuration>
+</pre></div></div>
+
+<p>result:</p>
+
+<div>
+<div>
+<pre class="source"><configuration>
+ <items>
+ <item>one</item>
+ <item>two</item>
+ <item>three</item>
+ </items>
+</configuration>
+</pre></div></div>
+
+<p>(If you’re using an earlier version of Maven than trunk (revId 545315), the order above will be three, one, two.)</p></section><section>
+<h3><a name="Why_do_I_not_get_an_index.html_page_generated_for_my_project_website.3F"></a>Why do I not get an index.html page generated for my project website?</h3>
+<p>The usual cause of this is configuring maven-project-info-reports plugin and leaving out the ‘index’ report.</p>
+
+<div>
+<div>
+<pre class="source"> <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-project-info-reports-plugin</artifactId>
+ <reportSets>
+ <reportSet>
+ <reports>
+ <report>index</report> <--------- here!
+ <report>dependencies</report>
+ <report>cim</report>
+ <report>scm-list</report>
+ <report>issue-tracking</report>
+ </reports>
+ </reportSet>
+ </reportSets>
+ </plugin>
+</pre></div></div>
+</section><section>
+<h3><a name="How_do_I_resolve_the_.E2.80.9C.3C_plugin_name_.3E_does_not_exist_or_no_valid_version.E2.80.9D_error.3F"></a>How do I resolve the “< plugin name > does not exist or no valid version” error?</h3>
+<p>This error indicates that Maven is either unable to access the required plug-in from your local repository, or unable to access the official or central Maven plug-in repository.</p>
+<p>To resolve this error: - If you are behind a http proxy, please check the Maven2 <a class="externalLink" href="http://maven.apache.org/guides/mini/guide-proxies.html">proxy settings guide</a>. - If you are upgrading Maven from an older version, try running with -U. This will force an update check on all plug-ins.</p>
+<p>If the error persists, browse <a class="externalLink" href="http://www.mail-archive.com/users@maven.apache.org/">archived discussions</a>, post to the Maven user list, or log a <a class="externalLink" href="http://jira.codehaus.org/browse/MNG">ticket</a> describing your problem, if you think it is a bug. Tickets may also be issued for feature enhancement requests, and other tasks.</p>
+<p>There is a known issue with Maven as of 2.0.4 which is related to metadata files being corrupted during plugin version resolution. For more information, and for a workaround, see <a class="externalLink" href="http://jira.codehaus.org/browse/MNG-2408">MNG-2408</a>.</p>
+<p><i>Dependencies</i></p></section><section>
+<h3><a name="How_do_I_implement_.E2.80.9Cmaven.jar.override.E2.80.9D_of_Maven_1_with_Maven_2.3F"></a>How do I implement “maven.jar.override” of Maven 1 with Maven 2?</h3>
+<p>Assume you have an open source project on Source Forge which uses some 3rd party libraries which are not available in any public Maven repository. Still, you want to build your project with Maven 2 - how to deal with those unavailable dependencies? Maven 1 allowed to override the path of files of dependencies, with a relative path, for example to a .jar file included in the projects’ CVS structure. Maven 2 does not support that, so one way to achieve the same thing is: * Create a multi-module project. The first module contains the local 3rd-party jar files, at any location, with any name. As a simple example, just one file, under the path “src/build/jars/acme-worker12.jar” * The purpose of the first sub-module is to install the 3rd party .jar file into your local Maven 2 repository through the maven “install” plugin. This plugin allows to install any given file under any “groupId”, “artifactId” and “version
01d;:</p>
+
+<div>
+<div>
+<pre class="source"><build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-install-plugin</artifactId>
+ <executions>
+ <execution>
+ <id>copy-acme</id>
+ <phase>validate</phase>
+ <goals>
+ <goal>install-file</goal>
+ </goals>
+ <configuration>
+ <file>${basedir}/src/build/jars/acme-worker-12.jar</file>
+ <groupId>acme</groupId>
+ <artifactId>worker</artifactId>
+ <version>1.2</version>
+ <packaging>jar</packaging>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+</build>
+</pre></div></div>
+
+<ul>
+
+<li>In the second module, where your actual project code is, create a dependency based on the “groupId”, “artifactId” and “version” that you used to install the 3rd party libary.</li>
+</ul>
+
+<div>
+<div>
+<pre class="source"><dependencies>
+ <dependency>
+ <groupId>acme</groupId>
+ <artifactId>worker</artifactId>
+ <version>1.2</version>
+ </dependency>
+</dependencies>
+</pre></div></div>
+
+<p>One word of caution, though; if you include - for whatever reason Junit like that, it MUST be deployed under - and referred to as - the group id “junit”, or the build will break, due to some hardwired dependencies of the current Surefire plugin.</p>
+<p><i>Errors, Dependencies, Plugins</i></p></section><section>
+<h3><a name="How_do_I_install_a_file_in_my_local_repository_along_with_a_generic_POM.3F"></a>How do I install a file in my local repository along with a generic POM?</h3>
+<p>This solution requires at least 2.0.1-SNAPSHOT or above version of Maven 2. You may do this by typing this command (please take note that this is a single line only).</p>
+
+<div>
+<div>
+<pre class="source">mvn install:install-file
+ -DgroupId=<group-id>
+ -DartifactId=<artifact-id>
+ -Dversion=<version>
+ -Dfile=<path-to-file>
+ -Dpackaging=<packaging> (i.e. jar)
+ -DgeneratePom=true
+</pre></div></div>
+
+<p>This command installs the jar in your local repository with the generated generic pom. {{Well, this doesn’t work in Maven 2.0.2. It just gives the message “Cannot execute mojo: install-file. It requires a project with an existing pom.xml, but the build is not using one.” -<a class="externalLink" href="mailto:-kreiger@imcode.com">-kreiger@imcode.com</a>}}</p>
+<p><i>Repositories</i></p></section><section>
+<h3><a name="How_do_I_install_a_file_in_my_local_repository_along_with_my_customized_POM.3F"></a>How do I install a file in my local repository along with my customized POM?</h3>
+<p>The solution requires at least 2.0.1-SNAPSHOT or above version of Maven 2 and add the -DpomFile=<path-to-pom> parameter just like the sample below.</p>
+
+<div>
+<div>
+<pre class="source">mvn install:install-file
+ -DgroupId=<group-id>
+ -DartifactId=<artifact-id>
+ -Dversion=<version>
+ -Dfile=<path-to-file>
+ -Dpackaging=<packaging> (i.e. jar)
+ -DpomFile=<path-to-pom>
+</pre></div></div>
+
+<p>This command will install the file in your local repository along with your customed pom. <i>Repositories</i></p></section><section>
+<h3><a name="How_do_I_include.2Fexclude_the_other_modules_in_the_navigation_menu_in_the_parent_site.3F"></a>How do I include/exclude the other modules in the navigation menu in the parent site?</h3>
+<p><a class="externalLink" href="http://jira.codehaus.org/browse/MNG-661">MNG-661</a>, provides a simple patch which provides parent and module links using the project URLs which as you correctly point out only work when the site is deployed.</p>
+<p><i>Plugins & Lifecycle</i></p></section><section>
+<h3><a name="Does_Maven_2.x_support_pre.2FpostGoals.3F"></a>Does Maven 2.x support pre/postGoals?</h3>
+<p>Maven 2.x no longer supports pre/postGoals, which were used in Maven 1.x to inject custom behavior to the build process. This caused a problem, since declaring your code to be a preGoal of some other goal meant that you depended on that specific goal, rather than the work it did. It also caused confusion when trying to inject other behavior into a build that already had pre/postGoals attached: Where would the new behavior be injected?</p>
+<p>Pre- and post-goals in Maven 1.x were usually used to develop the concept of a workflow, or lifecycle, for the build, where <i>x</i> happened before <i>y</i>, which had to happen before the sources could be compiled. In Maven 2, we’ve incorporated this concept of a build lifecycle natively. The steps - or phases - in this lifecycle correspond to the types of actions that might occur in a build. Your plugin can declare which type of action it performs - or which phase it should bind to - and that will guarantee it is executed before the next action type. For example, if your plugin generates some source code, you might want it to bind to the “generate-sources” lifecycle phase, so it is guaranteed to run before the “compile” phase.</p>
+<p>For more information, see <a class="externalLink" href="http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html">Introduction to the Build Lifecycle</a></p>
+<p><i>General</i></p></section><section>
+<h3><a name="What_is_the_difference_between_Maven_and_Ivy.3F"></a>What is the difference between Maven and Ivy?</h3>
+<p>For a comparison of Maven’s features vs Ivy’s you can refer to our <a class="externalLink" href="http://docs.codehaus.org/display/MAVEN/Feature+Comparisons">feature comparison</a></p>
+<p><i>General</i></p></section><section>
+<h3><a name="How_do_I_get_a_plug-in.E2.80.99s_dependencies_from_a_Mojo.3F"></a>How do I get a plug-in’s dependencies from a Mojo?</h3>
+
+<div>
+<div>
+<pre class="source">public class MyMojo
+ extends AbstractMojo
+{
+ /**
+ * @parameter expression="${plugin.artifacts}"
+ * @required
+ */
+ private List pluginArtifacts;
+
+ public void execute()
+ throws MojoExecutionException
+ {
+ ...
+ for ( Iterator i = pluginArtifacts.iterator(); i.hasNext(); )
+ {
+ Artifact pluginArtifact = (Artifact) i.next();
+ }
+ ...
+ }
+}
+</pre></div></div>
+</section><section>
+<h3><a name="How_do_I_get_the_project.E2.80.99s_sources_from_a_Mojo.3F"></a>How do I get the project’s sources from a Mojo?</h3>
+
+<div>
+<div>
+<pre class="source">public class MyMojo
+ extends AbstractMojo
+{
+ /**
+ * @parameter expression="${project.compileSourceRoots}"
+ * @required
+ */
+ private List sourceRoots;
+
+ public void execute()
+ throws MojoExecutionException
+ {
+ ...
+ for ( Iterator i = sourceRoots.iterator(); i.hasNext(); )
+ {
+ String sourceRoot = (String) i.next();
+
+ // Do what you want with these directories
+ }
+ }
+}
+</pre></div></div>
+</section><section>
+<h3><a name="Does_the_v4.0.0_POM_include_a_.3C_versions.2F_.3E_element.3F"></a>Does the v4.0.0 POM include a < versions/ > element?</h3>
+<p>The POM does not inlcude a <versions/> element. The POM reflects the current state of a project’s build only, not a historical build log. The POM is not designed to track historical information, as it would be difficult for developers to always add this information manually, i.e., to always remember to add it or to ensure that the correct information is added when multiple branches are involved.</p>
+<p>However, if the SCM tag of the <scm> section of the POM is populated, the repository records build versions, enabling developers to reconstruct the information for each released build.</p>
+<p><i>POM, General</i></p></section><section>
+<h3><a name="How_do_I_create_a_report_that_does_not_require_Doxia.E2.80.99s_Sink_interface.3F"></a>How do I create a report that does not require Doxia’s Sink interface?</h3>
+<p>Make it a report and override the isExternalReport() method to return true.</p>
+<p><i>Sites & Reporting</i></p></section><section>
+<h3><a name="How_do_I_prevent_verification_warnings_with_custom_repositories.3F"></a>How do I prevent verification warnings with custom repositories?</h3>
+<p>Warnings from custom repositories (usually located within the organization’s network, or even on the same workstation) are triggered when Maven tries to verify the integrity of the files in the repository. This verification is done via the SHA1 or MD5 sum of the file. If these sum files do not exist, then a warning appears.</p>
+<p>Support for downloading the security sum files is not yet included in the Maven2 distribution. There are free command-line utilities on the Internet that generate these sums. Below is an example of a bash script (use <a class="externalLink" href="http://cygwin.com">Cygwin</a> if you are using a windows machine) that generates sha1sum for all jar, xml and pom files contained in the directory where it is executed:</p>
+
+<div>
+<div>
+<pre class="source">#!/usr/bin/bash
+
+gensum(){
+ shaname=$1.sha1
+
+ sum=`sha1sum $1 ]( cut -f1 -d" "`
+ echo $sum > $shaname
+}
+
+processFile(){
+ while read oneline
+ do
+ gensum $oneline
+
+
+ done < "$1"
+}
+
+tmpFile=$TMP/shagen.list
+
+echo "Generating sha1 sums for XML files"
+find . -name "*.xml" > "$tmpFile"
+
+processFile "$tmpFile"
+
+echo "Generating sha1 sums for POM files"
+find . -name "*.pom" > "$tmpFile"
+
+processFile "$tmpFile"
+
+echo "Generating sha1 sums for JAR files"
+find . -name "*.jar" > "$tmpFile"
+
+processFile "$tmpFile"
+
+rm "$tmpFile"
+</pre></div></div>
+
+<p>The script above has been tested on <a class="externalLink" href="http://cygwin.com">Cygwin</a> and is provided “as-is” and with no guarantee. <i>Errors, Repositories</i></p></section><section>
+<h3><a name="What_does_the_.22ERROR:_Cannot_override_read-only_parameter:_.3Cparameter_name.3E_.22_message.2C_when_running_.3Cplugin_name.3E:_mean.3F"></a>What does the "ERROR: Cannot override read-only parameter: <parameter_name> " message, when running <plugin_name>: mean?</h3>
+<p>This means that the parameter being overriden in the pom.xml is read-only. Hence, it is not possible to override this parameter.</p>
+<p><i>Errors, POM</i></p></section><section>
+<h3><a name="How_do_I_generate_Maven_plug-in_sites.2C_with_pages_that_include_an_overview_of_the_goals_and_parameters_for_each_plug-in.3F"></a>How do I generate Maven plug-in sites, with pages that include an overview of the goals and parameters for each plug-in?</h3>
+<p>Include maven-plugin-plugin as a report.</p>
+<p><i>Plugin Requests, Sites & Reporting</i></p></section><section>
+<h3><a name="Can_I_define_the_antrun_plugin_to_be_executed_on_demand_like_.E2.80.9Cmvn_antrun:run.E2.80.9D.3F"></a>Can I define the antrun plugin to be executed on demand like “mvn antrun:run”?</h3>
+<p>The antrun plugin can be executed on demand only if: - the top level configuration of the plugin contains all the information - a variable is passed from the command line, eg -Dtarget=foo antrun:run - the appropriate target in the script is executed based on the variable</p>
+<p>However, it is recommended that developers write plugins for their goals (Ant support for plugins will be available soon, currently you must write them in java or beanshell).</p>
+<p><i>Plugins and Lifecycle, Ant-related</i></p></section><section>
+<h3><a name="How_do_I_properly_populate_variables.2C_when_extending_a_mojo_from_another_plugin.3F"></a>How do I properly populate variables, when extending a mojo from another plugin?</h3>
+<p>When creating plugins, the field metadata is read from source files, so it is not available when the original source is not available. While the metadata is available in the plugin in META-INF/maven/plugin.xml, currently, there is no way to incorporate it when building a new plugin.</p>
+<p>It is currently recommended that plug-ins be built using composition, instead of inheritence.</p>
+<p><i>Plugin Requests, Design, Patterns & Best Practices</i></p></section><section>
+<h3><a name="How_do_I_access_artifacts_if_Ibiblio_is_down.3F"></a>How do I access artifacts if Ibiblio is down?</h3>
+<p>To access artifacts if Ibiblio is down, use any of its mirror sites.</p>
+<p><a class="externalLink" href="http://maven.apache.org/guides/mini/guide-mirror-settings.html">Guide mirror settings</a></p>
+<p><i>Repositories, General</i></p></section><section>
+<h3><a name="How_do_I_get_a_list_of_archetypes.3F"></a>How do I get a list of archetypes?</h3>
+<p>To get a list of archetypes, refer to the following page [<a class="externalLink" href="http://svn.apache.org/viewcvs.cgi/maven/archetype/trunk/maven-archetypes">http://svn.apache.org/viewcvs.cgi/maven/archetype/trunk/maven-archetypes</a>)</p></section><section>
+<h3><a name="How_do_I_specify_my_remote_repo_in_Maven_2.0_.28i.e..2C_what_is_the_equivalent_of_.E2.80.98maven.repo.remote.E2.80.99_in_Maven_1.x.29.3F"></a>How do I specify my remote repo in Maven 2.0 (i.e., what is the equivalent of ‘maven.repo.remote’ in Maven 1.x)?</h3>
+<p>To specify a remote repo in Maven 2.0, add the <repositories> element to the POM:</p>
+
+<div>
+<div>
+<pre class="source"><repositories>
+ <repository>
+ <id>my-repo2</id>
+ <name>your custom repo</name>
+ <url>http://jarsm2.dyndns.dk</url>
+ </repository>
+</repositories>
+</pre></div></div>
+
+<p>Or, refer to the following page [<a class="externalLink" href="http://maven.apache.org/guides/mini/guide-multiple-repositories.html">http://maven.apache.org/guides/mini/guide-multiple-repositories.html</a>) <i>Repositories</i></p></section><section>
+<h3><a name="How_do_I_specify_which_output_folders_the_Eclipse_plugin_puts_into_the_.classpath_file.3F"></a>How do I specify which output folders the Eclipse plugin puts into the .classpath file?</h3>
+
+<div>
+<div>
+<pre class="source"><build>
+...
+ <pluginManagement>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-eclipse-plugin</artifactId>
+ <configuration>
+ <outputDirectory>target-eclipse</outputDirectory>
+ </configuration>
+ </plugin>
+ </plugins>
+ </pluginManagement>
+...
+</build>
+</pre></div></div>
+
+<p><i>Plugins and Lifecycle, IDEs</i></p></section><section>
+<h3><a name="How_do_I_invoke_the_.E2.80.9Cmaven_dist.E2.80.9D_function_from_Maven_1.0.2C_in_Maven_2.0.3F"></a>How do I invoke the “maven dist” function from Maven 1.0, in Maven 2.0?</h3>
+<p>mvn assembly:assembly</p>
+<p>See the <a class="externalLink" href="http://maven.apache.org/plugins/maven-assembly-plugin/">Assembly Plugin documentation</a> for more details.</p>
+<p><i>General, Plugins and Lifecycle</i></p></section><section>
+<h3><a name="Can_a_profile_inherit_the_configuration_of_a_.E2.80.9Csibling.E2.80.9D_profile.3F"></a>Can a profile inherit the configuration of a “sibling” profile?</h3>
+<p>No. Profiles merge when their ID’s match - so you can inherit them from a parent POM (but you can’t inherit profiles from the same POM).</p>
+<p><i>Inheritence and Interpolation, Plugins and Lifecycle, POM</i></p></section><section>
+<h3><a name="How_do_I_run_an_ant_task_twice.2C_against_two_different_phases.3F"></a>How do I run an ant task twice, against two different phases?</h3>
+<p>You can specify multiple execution elements under the executions tag, giving each a different id and binding them at different phases.</p>
+
+<div>
+<div>
+<pre class="source"><plugin>
+ <artifactId>maven-antrun-plugin</artifactId>
+ <executions>
+ <execution>
+ <id>one</id>
+ <phase>generate-sources</phase>
+ <configuration>
+ <tasks>
+ <echo message="generate-sources!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"/>
+ </tasks>
+ </configuration>
+ <goals>
+ <goal>run</goal>
+ </goals>
+ </execution>
+
+ <execution>
+ <id>two</id>
+ <phase>package</phase>
+ <configuration>
+ <tasks>
+ <echo message="package!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"/>
+ </tasks>
+ </configuration>
+ <goals>
+ <goal>run</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+</pre></div></div>
+
+<p><i>Ant-related</i></p></section><section>
+<h3><a name="How_do_I_prevent_tests_from_running_twice.2C_after_adding_a_configuration_for_the_surefire_plugin.3F"></a>How do I prevent tests from running twice, after adding a configuration for the surefire plugin?</h3>
+<p>Declare the configuration outside of the executions tag of the plugin.</p>
+
+<div>
+<div>
+<pre class="source"><plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.0</version>
+ <configuration>
+ <systemProperties>
+ <property>
+ <name>net.sourceforge.cobertura.datafile</name>
+ <value>C:\cobertura.ser</value>
+ </property>
+ </systemProperties>
+ </configuration>
+</plugin>
+</pre></div></div>
+
+<p><i>Plugins and Lifecycle, Sites & Reporting</i></p></section><section>
+<h3><a name="How_do_I_integrate_static_.28x.29html_into_my_Maven_site.3F"></a>How do I integrate static (x)html into my Maven site?</h3>
+<p>You can integrate your static pages in this several steps, * Put your static pages in the resources directory, ${basedir}/src/site/resources. * Create your site.xml and put it in ${basedir}/src/site. An example below:</p>
+
+<div>
+<div>
+<pre class="source"><project name="Maven War Plugin">
+ <bannerLeft>
+ <name>Maven War Plugin</name>
+ <src>http://maven.apache.org/images/apache-maven-project.png</src>
+ <href>http://maven.apache.org/</href>
+ </bannerLeft>
+ <bannerRight>
+ <src>http://maven.apache.org/images/maven-small.gif</src>
+ </bannerRight>
+ <body>
+ <links>
+ <item name="Maven 2" xhref="http://maven.apache.org/maven2/"/>
+ </links>
+
+ <menu name="Overview">
+ <item name="Introduction" xhref="introduction.html"/>
+ <item name="How to Use" xhref="howto.html"/>
+ </menu>
+ ${reports}
+ </body>
+</project>
+</pre></div></div>
+
+<ul>
+
+<li>Link the static pages by modifying the <menu> section, create items and map it with the filename of the static pages.</li>
+</ul>
+
+<div>
+<div>
+<pre class="source"><menu name="Overview">
+ <item name="Introduction" xhref="introduction.html"/>
+ <item name="How to Use" xhref="howto.html"/>
+ <item name="<put-name-here>" xhref="<filename-of-the-static-page>"/>
+</menu>
+</pre></div></div>
+
+<p> <i>Sites & Reporting</i></p></section><section>
+<h3><a name="How_do_I_specify_that_all_web_modules_will_inherit_the_group.E2.80.99s_common_files_from_a_parent_web_module.3F"></a>How do I specify that all web modules will inherit the group’s common files from a parent web module?</h3>
+<p>maven-war-plugin 2.0-beta-3 and later supports merging of wars. Just reference the common WAR project from another WAR project as a dependency of <type>war</type> and it will automatically be merged.</p>
+<p>See [<a class="externalLink" href="http://jira.codehaus.org/browse/MWAR-8">http://jira.codehaus.org/browse/MWAR-8</a>)</p>
+<p><i>Inheritence and Interpolation</i></p></section><section>
+<h3><a name="How_do_I_determine_which_POM_contains_missing_transitive_dependency.3F"></a>How do I determine which POM contains missing transitive dependency?</h3>
+<p>run mvn -X</p>
+<p><i>POM, Dependencies</i></p></section><section>
+<h3><a name="Is_there_a_property_file_for_plug-in_configuration_in_Maven_2.0.3F"></a>Is there a property file for plug-in configuration in Maven 2.0?</h3>
+<p>No. Maven 2.x no longer supports plug-in configuration via properties files. Instead, in Maven 2.0 you can configure plug-ins directly from command line using the -D arguement, or from the plug-in’s POM using the <configuration> element.</p>
+<p><i>General, POM, Plugins and Lifecycle, Command Line</i></p></section><section>
+<h3><a name="How_do_I_determine_the_stale_resources_in_a_Mojo_to_avoid_reprocessing_them.3F"></a>How do I determine the stale resources in a Mojo to avoid reprocessing them?</h3>
+<p>This can be done using the following piece of code:</p>
+
+<div>
+<div>
+<pre class="source">// Imports needed
+import org.codehaus.plexus.compiler.util.scan.InclusionScanException;
+import org.codehaus.plexus.compiler.util.scan.StaleSourceScanner;
+import org.codehaus.plexus.compiler.util.scan.mapping.SuffixMapping;
+
+// At some point of your code
+ StaleSourceScanner scanner = new StaleSourceScanner( 0, Collections.singleton( "**/*.xml" ), Collections.EMPTY_SET );
+ scanner.addSourceMapping( new SuffixMapping( ".xml", ".html" ) );
+ Set<File> staleFiles = (Set<File>) scanner.getIncludedSources( this.sourceDirectory, this.targetDirectory );
+</pre></div></div>
+
+<p>The second parameter to the StaleSourceScanner is the set of includes, while the third parameter is the set of excludes. You must add a source mapping to the scanner (second line). In this case we’re telling the scanner what is the extension of the result file (.html) for each source file extension (.xml). Finally we get the stale files as a Set<File> calling the getIncludedSources method, passing as parameters the source and target directories (of type File). The Maven API doesn’t support generics, but you may cast it that way if you’re using them. In order to use this API you must include the following dependency in your pom:</p>
+
+<div>
+<div>
+<pre class="source"><dependencies>
+ <dependency>
+ <groupId>org.codehaus.plexus</groupId>
+ <artifactId>plexus-compiler-api</artifactId>
+ <version>1.5.1</version>
+ </dependency>
+</dependencies>
+</pre></div></div>
+
+<p><i>POM, Plugin API</i></p></section><section>
+<h3><a name="What_does_the_FATAL_ERROR_with_the_message_.E2.80.9CClass_org.apache.commons.logging.impl.Jdk14Logger_does_not_implement_Log.E2.80.9D_when_using_the_maven-checkstyle-plugin_mean.3F"></a>What does the FATAL ERROR with the message <i>“Class org.apache.commons.logging.impl.Jdk14Logger does not implement Log”</i> when using the maven-checkstyle-plugin mean?</h3>
+<p>Checkstyle uses commons-logging, which has classloader problems when initialized within a Maven plugin’s container. This results in the above message - if you run with ‘-e’, you’ll see something like the following:</p><hr /></section></section><section>
+<h2><a name="Caused_by:_org.apache.commons.logging.LogConfigurationException:_org.apache.commons.logging.LogConfigurationException:_Class_org.apache.commons.logging.impl.Jdk14Logger_does_not_implement_Log"></a>Caused by: org.apache.commons.logging.LogConfigurationException: org.apache.commons.logging.LogConfigurationException: Class org.apache.commons.logging.impl.Jdk14Logger does not implement Log</h2>
+<p>buried deep in the stacktrace.</p>
+<p>The only workaround we currently have for this problem is to include another commons-logging Log implementation in the plugin itself. So, you can solve the problem by adding the following to your plugin declaration in your POM:</p>
+
+<div>
+<div>
+<pre class="source"><project>
+ ...
+ <build>
+ ...
+ <plugins>
+ ...
+ <plugin>
+ <artifactId>maven-checkstyle-plugin</artifactId>
+ <dependencies>
+ <dependency>
+ <groupId>log4j</groupId>
+ <artifactId>log4j</artifactId>
+ <version>1.2.12</version>
+ </dependency>
+ </dependencies>
+ </plugin>
+ </plugins>
+ </build>
+ ...
+ <reporting>
+ ...
+ <plugins>
+ <!-- your checkstyle report is registered here, according to Maven documentation -->
+ </plugins>
+ </reporting>
+</project>
+</pre></div></div>
+
+<p>While this may seem a counter-intuitive way of configuring a report, it’s important to remember that Maven plugins can have a mix of reports and normal mojos. When a POM has to configure extra dependencies for a plugin, it should do so in the normal plugins section. We will probably try to fix this problem before the next release of the checkstyle plugin.</p>
+<p><i>UPDATE:</i> This problem has been fixed in the SVN trunk version of the checkstyle plugin, which should be released very soon. <i>Plugins and Lifecycle, Sites & Reporting, Errors</i></p><section>
+<h3><a name="Where_do_I_configure_report_plug-ins.2C_like_javadoc.3F"></a>Where do I configure report plug-ins, like javadoc?</h3>
+<p>Generally, you should configure reporting in the <reporting> (vs. <build>) section of the POM. Configuration there applies to both the site, and when run on the command line, and adding the plugin there adds the report to the generated site.</p>
+<p>Configuration in the build section is only used during the normal lifecycle or the command line invocation (eg javadoc:javadoc).</p>
+<p>Configuration should go there if you do not want the report on the site, or the configuration differs from what is on the site (eg, some plugins have a fail build option).</p>
+<p><i>Sites & Reporting, Plugins and Lifecycle, Command Line</i></p></section><section>
+<h3><a name="How_do_I_deploy_my_binary_during_the_deploy_phase.3F"></a>How do I deploy my binary during the deploy phase?</h3>
+
+<div>
+<div>
+<pre class="source"><plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-assembly-plugin</artifactId>
+ <executions>
+ <execution>
+ <phase>install</phase>
+ <goals>
+ <goal>assembly</goal>
+ </goals>
+ <configuration>
+ <!-- put your config here -->
+ </configuration>
+ </execution>
+ </executions>
+</plugin>
+</pre></div></div>
+
+<p>Then run mvn deploy. <i>Deployment</i></p></section><section>
+<h3><a name="How_do_I_add_main_class_in_a_generated_jar.E2.80.99s_manifest.3F"></a>How do I add main class in a generated jar’s manifest?</h3>
+<p>Configure the maven-jar-plugin and add your main class.</p>
+
+<div>
+<div>
+<pre class="source"><plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-jar-plugin</artifactId>
+ <configuration>
+ <archive>
+ <manifest>
+ <mainClass>com.mycompany.app.App</mainClass>
+ </manifest>
+ </archive>
+ </configuration>
+</plugin>
+</pre></div></div>
+</section><section>
+<h3><a name="How_do_I_install_artifacts_to_a_remote_repository.3F"></a>How do I install artifacts to a remote repository?</h3>
+<p>You need at least 2.1-SNAPSHOT version of maven-deploy-plugin to make this work, current workaround to use this is to copy the wagon provider jar (ie. wagon-ftp-1.0-alpha-3.jar) in your %M2_HOME%/lib and execute the command:</p>
+
+<div>
+<div>
+<pre class="source">mvn deploy:deploy-file
+ -DgroupId=<groupId>
+ -DartifactId=<artifactId>
+ -Dversion=<version>
+ -Dpackaging=<packaging>
+ -Dfile=<path-to-file>
+ -DrepositoryId=<id-to-map-on-server>
+ -Durl=<url-of-remote-repo>
+</pre></div></div>
+
+<p><i>Repositories, Command Line</i></p></section><section>
+<h3><a name="Does_a_POM_inherit_its_resources.3F"></a>Does a POM inherit its resources?</h3>
+<p>Yes, resources are inherited, but only if the child pom does not define any resources. If it does, then the project just uses those resources defined in its pom and the parents resources are overridden.</p>
+<p><i>POM, Inheritence and Interpolation</i></p></section><section>
+<h3><a name="How_do_I_use_SNAPSHOT_versions_of_plug-ins.3F"></a>How do I use SNAPSHOT versions of plug-ins?</h3>
+<p>[http://maven.apache.org/guides/development/guide-testing-development-plugins.html]</p></section><section>
+<h3><a name="How_do_I_run_a_build.2Fpackage.2Fdeploy_process_without_waiting_for_reports_or_unit_tests.2C_in_order_to_quickly_deploy_to_an_integration_box.3F"></a>How do I run a build/package/deploy process without waiting for reports or unit tests, in order to quickly deploy to an integration box?</h3>
+<p>You could create a specific profile that skips the reporting and test phases.</p>
+<p>Also refer to [How do I skip unit tests when building a project?](How do I skip unit tests when building a project?)</p></section><section>
+<h3><a name="How_do_I_configure_the_equivalent_of_maven.war.src_of_war_plugin_in_Maven_2.0.3F"></a>How do I configure the equivalent of maven.war.src of war plugin in Maven 2.0?</h3>
+
+<div>
+<div>
+<pre class="source"><build>
+ ...
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-war-plugin</artifactId>
+ <configuration>
+ <warSourceDirectory><!-- put the path of the directory --></warSourceDirectory>
+ </configuration>
+ </plugin>
+ </plugins>
+ ...
+</build>
+</pre></div></div>
+
+<p>See [http://maven.apache.org/plugins/maven-war-plugin/war-mojo.html] for other configurable properties of the war plugin.</p></section><section>
+<h3><a name="How_do_I_execute_the_assembly_plugin_with_different_configurations.3F"></a>How do I execute the assembly plugin with different configurations?</h3>
+<p>Add this to your pom,</p>
+
+<div>
+<div>
+<pre class="source"><build>
+ ...
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-assembly-plugin</artifactId>
+ <executions>
+ <execution>
+ <id>1</id>
+ <phase>install</phase>
+ <goals>
+ <goal>assembly</goal>
+ </goals>
+ <configuration>
+ <descriptor>src/main/descriptors/bin.xml</descriptor>
+ <finalName>${project.build.finalName}-bin</finalName>
+ </configuration>
+ </execution>
+
+ <execution>
+ <id>2</id>
+ <phase>install</phase>
+ <goals>
+ <goal>assembly</goal>
+ </goals>
+ <configuration>
+ <descriptor>src/main/descriptors/src.xml</descriptor>
+ <finalName>${project.build.finalName}-src</finalName>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ ...
+
+</build>
+</pre></div></div>
+
+<p>and run mvn install, this will execute the assembly plugin twice with different config.</p></section><section>
+<h3><a name="What_is_Maven.E2.80.99s_order_of_inheritance.3F"></a>What is Maven’s order of inheritance?</h3>
+<ul>
+
+<li>parent pom</li>
+<li>project pom</li>
+<li>settings</li>
+<li>CLI parameters</li>
+</ul>
+<p>where the last overrides the previous.</p>
+<p><i>General, Inheritence and Interpolation, Design, Patterns & Best Practices</i></p></section><section>
+<h3><a name="How_do_I_add_my_generated_sources_to_the_compile_path_of_Maven.2C_when_using_modello.3F"></a>How do I add my generated sources to the compile path of Maven, when using modello?</h3>
+<p>Modello generate the sources in the generate-sources phase and automatically adds the source directory for compilation in maven. So you don’t have to copy the generated sources.</p>
+<p>You have to declare the modello-plugin in the build of your plugin for source generation (in that way the sources are generated each time).</p>
+<p><i>Plugins and Lifecycle</i></p></section><section>
+<h3><a name="Can_I_add_a_java_source_to_my_war_package.3F"></a>Can I add a java source to my war package?</h3>
+<p>You can’t, but you can use the assembly plugin to create a source distribution and a binary distribution for your project</p>
+<p>Please refer to these sites for more info [http://maven.apache.org/guides/mini/guide-assemblies.html] [http://maven.apache.org/plugins/maven-assembly-plugin/howto.html]</p>
+<p><i>Deployments, Plugins and Lifecycle</i></p></section><section>
+<h3><a name="What_does_the_.E2.80.9CYou_cannot_have_two_plugin_executions_with_the_same_.28or_missing.29_.3Cid.2F.3E_elements.E2.80.9D_message_mean.3F"></a>What does the “You cannot have two plugin executions with the same (or missing) <id/> elements” message mean?</h3>
+<p>It means that you have executed a plugin multiple times with the same <id>. Provide each <execution> with a unique <id> then it would be ok.</p>
+<p><i>Errors, Plugins and Lifecycle</i></p></section><section>
+<h3><a name="Can_I_disable_transitive_dependencies.3F"></a>Can I disable transitive dependencies?</h3>
+<p>No you can’t, but you may exclude the dependencies you dont want to include in your project.</p>
+<p>Following is a sample on how to exclude transitive dependencies.</p>
+
+<div>
+<div>
+<pre class="source"><project>
+ ...
+ <dependency>
+ <groupId><!-- group id --></groupId>
+ <artifactId><!-- artifact id --></artifactId>
+ <version><!-- version --></version>
+ <scope><!-- scope --></scope>
+ <exclusions>
+ <exclusion>
+ <groupId><!-- groupId-of-the-artifact --></groupId>
+ <artifactId><!-- artifactId-of-the-artifact --></artifactId>
+ </exclusion>
+ </exclusions>
+ </dependency>
+</project>
+</pre></div></div>
+
+<p><i>Dependencies, Design, Patterns & Best Practices</i></p></section><section>
+<h3><a name="Where_can_I_get_offline_documentation_for_Maven.3F"></a>Where can I get offline documentation for Maven?</h3>
+<p>Check it out from [http://svn.apache.org/repos/asf/maven/site/trunk] and run mvn site:site</p>
+<p><i>General, Sites & Reporting</i></p></section><section>
+<h3><a name="How_do_I_skip_unit_tests_when_building_a_project.3F"></a>How do I skip unit tests when building a project?</h3>
+<p>Run the mvn command with -Dmaven.test.skip=true argument.</p>
+<p>Also see [How do I run a build/package/deploy process without waiting for reports or unit tests, so that I can quickly deploy to an integration box?]</p></section><section>
+<h3><a name="How_do_I_convert_my_.3Creports.3E_from_Maven_1_to_Maven_2.3F"></a>How do I convert my <reports> from Maven 1 to Maven 2?</h3>
+<p>In m1, we declare reports in the pom like this:</p>
+
+<div>
+<div>
+<pre class="source"><project>
+ ...
+ <reports>
+ <report>maven-checkstyle-plugin</report>
+ <report>maven-pmd-plugin</report>
+ </reports>
+</project>
+</pre></div></div>
+
+<p>In m2, the <reports> tag is replaced with <reporting></p>
+
+<div>
+<div>
+<pre class="source"><project>
+ ...
+ <reporting>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-checkstyle-plugin</artifactId>
+ <configuration>
+ <!-- put your config here -->
+ </configuration>
+ </plugin>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-pmd-plugin</artifactId>
+ <configuration>
+ <!-- put your config here -->
+ </configuration>
+ </plugin>
+ </plugins>
+ <reporting>
+</project>
+</pre></div></div>
+
+<p><i>Sites & Reporting, General</i></p></section><section>
+<h3><a name="How_do_I_create_a_command_line_parameter_.28i.e..2C_-Dname.3Dvalue_.29_in_my_mojo.3F"></a>How do I create a command line parameter (i.e., -Dname=value ) in my mojo?</h3>
+<p>In your mojo, put expression=$\{<exp>\} in your parameter field</p>
+
+<div>
+<div>
+<pre class="source">/**
+ * @parameter expression="${expression.name}"
+ */
+private String exp;
+</pre></div></div>
+
+<p>You may now able to pass parameter values to the command line. mvn \-Dexpression.name=value install</p>
+<p><i>Command Line</i></p></section><section>
+<h3><a name="What_is_the_purpose_of_displaying_read-only.2C_plug-in_fields_in_user_documentation.2C_if_they_are_not_configurable_in_the_project_descriptor.3F"></a>What is the purpose of displaying read-only, plug-in fields in user documentation, if they are not configurable in the project descriptor?</h3>
+<p>Often, parameters are specified as read-only to indicate that its value should be changed indirectly, rather than in the plugins <configuration/> section. For instance, I may have a plugin that declares a parameter as such:</p>
+
+<div>
+<div>
+<pre class="source">/**
+ * @parameter default-value="${project.build.directory}"
+ * @required
+ * @readonly
+ */
+ private File buildDir;
+</pre></div></div>
+
+<p>In this case, my plugin wants to output something to the project’s build directory. If this were configured directly on the plugin, it might not be cleaned up when the user issued <i>‘mvn clean’</i>, so instead I mark it as @readonly. This tells the user that she should modify the structure referenced by <i>default-value</i>(i.e. <project><build><directory/> in the POM) instead, which will allow this plugin to be a good citizen in the build process.</p></section><section>
+<h3><a name="I.E2.80.99ve_just_created_a_maven_plugin._Is_there_a_sample_plugin_integration_test_I_can_use.3F"></a>I’ve just created a maven plugin. Is there a sample plugin integration test I can use?</h3>
+<p>Each integration test is a separate project. For a plugin, you may want to create a project that will use your plugin and probably put it inside src/test/projects like maven-antrun-plugin, maven-eclipse-plugin, maven-javadoc-plugin and several others. These plugins can be found here: [https://svn.apache.org/repos/asf/maven/plugins/trunk]</p>
+<p><i>Plugins and Lifecycle, Sites & Reporting, Integration tests</i></p></section><section>
+<h3><a name="The_snapshot_version_of_the_plugin_is_not_updated_in_the_snapshot_repo.2C_What_should_I_do_to_update_my_copy_of_the_plugin.3F"></a>The snapshot version of the plugin is not updated in the snapshot repo, What should I do to update my copy of the plugin?</h3>
+<p>If the plugin in the snapshot repo ([http://snapshots.maven.codehaus.org/maven2]) is not yet updated. The only way to update it is to check out the source from SVN and build it.</p></section><section>
+<h3><a name="Is_there_a_way_to_get_Maven_to_report_the_number_of_compile_errors_found.3F"></a>Is there a way to get Maven to report the number of compile errors found?</h3>
+<p>Currently, this type of summary information is not built into the compiler plugin, but it would be possible to add. If this feature is important to you, add your vote to <a class="externalLink" href="http://jira.codehaus.org/browse/MNG-1854">MNG-1854</a>.</p>
+<p><i>Sites & Reporting</i></p></section><section>
+<h3><a name="In_a_multi-module_project.2C_is_there_any_way_for_maven_to_build_only_those_modules_that_have_changed_from_the_previous_build_and_leave_the_unchanged_modules_alone_.28i.e._not_build_them.29.3F"></a>In a multi-module project, is there any way for maven to build only those modules that have changed from the previous build and leave the unchanged modules alone (i.e. not build them)?</h3>
+<p>Currently, this is not possible. The main reason is that it’s a non-trivial to determine whether an entire project’s build is stale (the project here being one of the modules). It will be dependent on the phase being called, and the packaging of the particular module. This type of feature would have to be included in a design discussion on the [Maven 2.1 Discussion Wiki](<a class="externalLink" href="http://docs.codehaus.org/display/MAVEN/Maven+2.1+Design+Documents">http://docs.codehaus.org/display/MAVEN/Maven+2.1+Design+Documents</a>].</p>
+<p><i>Design, Patterns & Best Practices</i></p></section><section>
+<h3><a name="Where_can_I_get_the_Maven_2_plugin_for_Eclipse.3F"></a>Where can I get the Maven 2 plugin for Eclipse?</h3>
+<p>[http://maven.apache.org/eclipse-plugin.html]</p>
+<p>There are some flash demos to show the user how to use the plugin.</p>
+<p><i>IDEs</i></p></section><section>
+<h3><a name="Handle_special_characters_in_site"></a>Handle special characters in site</h3>
+<p>A solution with eclipse and solaris</p>
+<p>In eclipse.ini : Adding -Dfile.encoding=ISO-8859-1</p>
+<p>If using xmlbuddy with eclipse to edit xdoc files set the encoding Honor encoding Default to ISO-8859-1</p>
+<p>Configuration in pom</p>
+
+<div>
+<div>
+<pre class="source"><plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-site-plugin</artifactId>
+ <configuration>
+ <outputEncoding>UTF-8</outputEncoding>
+ </configuration>
+ </plugin>
+</pre></div></div>
+
+<p>On the solaris machine In $HOME/.profile MAVEN_OPTS="-Xmx512m -Xms512m -Dfile.encoding=ISO-8859-1 (mx/ms not mandatory for m2 but for m1). LANG=en_US.ISO8859-15 <i>Sites & Reporting, IDEs</i></p></section><section>
+<h3><a name="How_do_I_generate_sources_with_the_antrun_plug-in.3F"></a>How do I generate sources with the antrun plug-in?</h3>
+<p>For instance to generate sources add the following to your plugins section NOTE: this may only work in the latest plugin version in SVN</p>
+
+<div>
+<div>
+<pre class="source"><plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-antrun-plugin</artifactId>
+ <dependencies>
+ <!-- add dependencies needed in your ant script -->
+ </dependencies>
+ <executions>
+ <execution>
+ <id>generate-sources</id>
+ <phase>generate-sources</phase>
+ <configuration>
+ <tasks>
+ <!-- this will delegate to an ant build.xml, you could embed here your ant tasks -->
+ <path id="classpath">
+ <path refid="maven.compile.classpath"/>
+ <path refid="maven.plugin.classpath"/>
+ </path>
+ <ant antfile="${basedir}/build.xml" dir="${basedir}" inheritRefs="true">
+ <target name="generate-sources"/>
+ </ant>
+ </tasks>
+ </configuration>
+ <goals>
+ <goal>run</goal>
+ </goals>
+ </execution>
+ </executions>
+</plugin>
+</pre></div></div>
+
+<p><i>Ant-related</i> </p></section><section>
+<h3><a name="Where_is_the_plugin-registry.xml.3F"></a>Where is the plugin-registry.xml?</h3>
+<p>From the settings.xml, you may enable it by setting <usePluginRegistry/> to true and the file will be in ~/.m2/plugin-registry.xml</p>
+<p><i>General, Plugins and Lifecycle</i></p></section><section>
+<h3><a name="Is_there_a_way_to_specify_a_different_output_directory_without_having_to_edit_the_pom_or_configuration_file_each_time_I_do_a_build.3F"></a>Is there a way to specify a different output directory without having to edit the pom or configuration file each time I do a build?</h3>
+<p>Yes. You can make use of the pom’s <properties> element to accomplish this.</p>
+<p>To do so, simply add the following fragment to your pom:</p>
+
+<div>
+<div>
+<pre class="source"><project>
+...
+ <build>
+ <directory>${directory}</directory>
+ <outputDirectory>${directory}/classes</outputDirectory>
+ <testOutputDirectory>${directory}/test-classes</testOutputDirectory>
+ </build>
+ <properties>
+ <directory>target</directory> <!-- will serve as the default -->
+ </properties>
+...
+</project>
+</pre></div></div>
+
+<p>Now, to specify a different output directory at runtime simply use the directory property as a mvn command line parameter; {code}mvn -Ddirectory=tmp package</p>
+
+<div>
+<div>
+<pre class="source">This will send the build's output files to the $\{basedir}/tmp directory.
+
+_POM, Command Line_
+
+### How do I compile 1.3 java sources with a 1.4.x or 1.5.x JDK?
+
+You need to specify the <compilerVersion> element to 1.3
+
+i.e.
+```<project>
+ ...
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-compiler-plugin</artifactId>
+ <configuration>
+ <verbose>true</verbose>
+ <fork>true</fork>
+ <executable><!-- path-to-javac --></executable>
+ <compilerVersion>1.3</compilerVersion>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ ...
+</project>
+</pre></div></div>
+</section><section>
+<h3><a name="How_do_I_change_the_default_remote_repository.3F"></a>How do I change the default remote repository?</h3>
+<p>Define in your POM a repository with “central” as the repository id.</p>
+
+<div>
+<div>
+<pre class="source"><repositories>
+ <repository>
+ :
+ <id>central</id>
+ <name>any name</name>
+ <url>http://your.remote.repo.url.org</url>
+ :
+ </repository>
+ </repositories>
+</pre></div></div>
+
+<p><i>Repositories</i></p></section><section>
+<h3><a name="I_have_my_web.xml_in_my_customed_directory_layout_for_my_webapp.2C_but_why_am_I_getting_the_error_.E2.80.9CDeployment_descriptor_.3CPath.3E.5CWEB-INF.5Cweb.xml_does_not_exist.E2.80.9D.3F"></a>I have my web.xml in my customed directory layout for my webapp, but why am I getting the error “Deployment descriptor <Path>\WEB-INF\web.xml does not exist”?</h3>
+<p>You may specify the path of your web.xml in your webapp by configuring maven-war-plugin.</p>
+
+<div>
+<div>
+<pre class="source"><build>
+ ...
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-war-plugin</artifactId>
+ <configuration>
+ <webXml><!-- path-to-your-webxml --></webXml>
+ </configuration>
+ </plugin>
+ </plugins>
+</build>
+</pre></div></div>
+
+<p><i>Errors, Deployment</i> </p></section><section>
+<h3><a name="Is_it_possible_to_specify_multiple_.3Cmodule.3E.28s.29_in_a_POM_at_a_greater_depth_than_1_level.3F"></a>Is it possible to specify multiple <module>(s) in a POM at a greater depth than 1 level?</h3>
+<p>Yes. This can be done in two ways: 1. add the extra path in the top level POM, or 2. add extra parent poms at different levels, if approriate.</p>
+<p>For example, you have the following structure: /A/pom.xml (multi-module POM) /A/B/C/pom.xml /A/B/C/D/pom.xml</p>
+<p>And you want the modules at level C and D built when the multi-module POM is built.</p>
+<p>For the first solution: Add the following at the top level POM:</p>
+
+<div>
+<div>
+<pre class="source"><modules>
+ <module>A/B</module>
+ ...
+<modules>
+</pre></div></div>
+
+<p>For the second solution: Add the following at the top level POM:</p>
+
+<div>
+<div>
+<pre class="source"><modules>
+ <module>B</module>
[... 695 lines stripped ...]