You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by bu...@apache.org on 2012/12/10 09:17:44 UTC
svn commit: r841370 [15/47] - in /websites/staging/maven/trunk/content: ./
ant/ background/ css/ 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/2.0.3/ docs/2.0.4/...
Added: websites/staging/maven/trunk/content/examples/maven-3-lifecycle-extensions.html
==============================================================================
--- websites/staging/maven/trunk/content/examples/maven-3-lifecycle-extensions.html (added)
+++ websites/staging/maven/trunk/content/examples/maven-3-lifecycle-extensions.html Mon Dec 10 08:17:24 2012
@@ -0,0 +1,323 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ | Generated by Apache Maven Doxia at Dec 10, 2012
+ | Rendered using Apache Maven Stylus Skin 1.5
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Maven - Example: Maven 3 lifecycle extension</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Olivier Lamy" />
+ <meta name="Date-Creation-yyyymmdd" content="20120307" />
+ <meta name="Date-Revision-yyyymmdd" content="20121210" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href=".././" id="bannerLeft">
+ <img src="../images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="../images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="../index.html">Maven</a>
+ >
+ Example: Maven 3 lifecycle extension
+ </div>
+ <div class="xright">
+ Last Published: 2012-12-10
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Main</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html">Welcome</a>
+ </li>
+ </ul>
+ <h5>Get Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="../download.html">Download</a>
+ </li>
+ <li class="none">
+ <a href="../docs/3.0.4/release-notes.html">Release Notes (3.0.4)</a>
+ </li>
+ <li class="none">
+ <a href="../docs/2.2.1/release-notes.html">Release Notes (2.2.1)</a>
+ </li>
+ <li class="none">
+ <a href="../docs/2.0.11/release-notes.html">Release Notes (2.0.11)</a>
+ </li>
+ <li class="none">
+ <a href="../license.html">License</a>
+ </li>
+ </ul>
+ <h5>IDE Integration</h5>
+ <ul>
+ <li class="none">
+ <a href="../eclipse-plugin.html">Eclipse</a>
+ </li>
+ <li class="none">
+ <a href="../netbeans-module.html">NetBeans</a>
+ </li>
+ </ul>
+ <h5>About Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="../what-is-maven.html">What is Maven?</a>
+ </li>
+ <li class="none">
+ <a href="../maven-features.html">Features</a>
+ </li>
+ <li class="none">
+ <a href="../general.html">FAQ (official)</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/FAQs-1" class="externalLink">FAQ (unofficial)</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <a href="../plugins/index.html">Maven Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../guides/index.html">Index (category)</a>
+ </li>
+ <li class="none">
+ <a href="../run-maven/index.html">Running Maven</a>
+ </li>
+ <li class="collapsed">
+ <a href="../users/index.html">User Centre</a>
+ </li>
+ <li class="collapsed">
+ <a href="../plugin-developers/index.html">Plugin Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="../repository/index.html">Maven Repository Centre</a>
+ </li>
+ <li class="none">
+ <a href="../developers/index.html">Maven Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="../articles.html">Books and Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/Home" class="externalLink">Wiki</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="../community.html">Community Overview</a>
+ </li>
+ <li class="none">
+ <a href="../guides/development/guide-helping.html">How to Contribute</a>
+ </li>
+ <li class="none">
+ <a href="../guides/mini/guide-maven-evangelism.html">Maven Repository</a>
+ </li>
+ <li class="none">
+ <a href="../users/getting-help.html">Getting Help</a>
+ </li>
+ <li class="none">
+ <a href="../issue-tracking.html">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="../source-repository.html">Source Repository</a>
+ </li>
+ <li class="none">
+ <a href="../team-list.html">The Maven Team</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html">Project Information</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../pom/index.html">Parent POMs</a>
+ </li>
+ <li class="none">
+ <a href="../plugins/index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-tools/index.html">Plugin Tools</a>
+ </li>
+ <li class="none">
+ <a href="../scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../skins/index.html">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements. See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership. The ASF licenses this file --><!-- to you 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/doxia/referen
ces/apt-format.html --><div class="section"><h2>Example: Using Maven 3 lifecycle extension<a name="Example:_Using_Maven_3_lifecycle_extension"></a></h2><div class="section"><h3>Lifecyle Participation<a name="Lifecyle_Participation"></a></h3><p>You can extends the class <tt>org.apache.maven.AbstractMavenLifecycleParticipant</tt> see <a class="externalLink" href="http://maven.apache.org/ref/current/apidocs/org/apache/maven/AbstractMavenLifecycleParticipant.html">javadoc</a>.</p></div><div class="section"><h3>Build your extension<a name="Build_your_extension"></a></h3><p>Create a Maven project with a dependency on org.apache.maven:maven-core:3.0.4 and other dependencies :</p><div class="source"><pre> <groupId>org.apache.maven.extensions</groupId>
+ <artifactId>beer-maven-lifecycle</artifactId>
+ <version>1.0-SNAPSHOT</version>
+
+ <dependency>
+ <groupId>org.apache.maven</groupId>
+ <artifactId>maven-core</artifactId>
+ <version>3.0.4</version>
+ </dependency>
+
+ <!-- dependency for plexus annotation -->
+ <dependency>
+ <groupId>org.codehaus.plexus</groupId>
+ <artifactId>plexus-component-annotations</artifactId>
+ <version>1.5.5</version>
+ <exclusions>
+ <exclusion>
+ <groupId>junit</groupId>
+ <artifactId>junit</artifactId>
+ </exclusion>
+ </exclusions>
+ </dependency></pre></div><p>Create your extension class</p><div class="source"><pre>// your extension must be a "Plexus" component so mark it with the annotation
+@Component( role = AbstractMavenLifecycleParticipant.class, hint = "beer")
+public class BeerMavenLifecycleParticipant extends AbstractMavenLifecycleParticipant
+{
+
+ @Override
+ public void afterSessionStart( MavenSession session )
+ throws MavenExecutionException
+ {
+ // start the beer machine
+ }
+
+
+ @Override
+ public void afterProjectsRead( MavenSession session )
+ throws MavenExecutionException
+ {
+ // ask a beer to the machine
+ }
+
+}</pre></div><p>Generate plexus metadatas during building your extension jar</p><div class="source"><pre> <build>
+ ...
+ <plugins>
+ ...
+ <plugin>
+ <groupId>org.codehaus.plexus</groupId>
+ <artifactId>plexus-component-metadata</artifactId>
+ <version>1.5.5</version>
+ <executions>
+ <execution>
+ <goals>
+ <goal>generate-metadata</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ ...
+ </plugins>
+ ...
+ </build></pre></div></div><div class="section"><h3>Use your extension in your build(s)<a name="Use_your_extension_in_your_builds"></a></h3><p>You have two ways to use your extension within your builds:</p><ul><li>add your extension jar in $M2_HOME/lib/ext.</li><li>add it as a build extension in your pom.</li></ul><p><b>NOTE</b>: if you use a build extension mechanism the method <tt>afterSessionStart</tt> <b>won't be called</b></p><p>Use a extension in your project, declare as it in your pom:</p><div class="source"><pre> <build>
+ ...
+ <extensions>
+ ...
+ <extension>
+ <groupId>org.apache.maven.extensions</groupId>
+ <artifactId>beer-maven-lifecycle</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ </extension>
+ ...
+ </extensions>
+ ...
+ </build></pre></div></div></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2012
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/maven/trunk/content/extpaths.txt
==============================================================================
--- websites/staging/maven/trunk/content/extpaths.txt (added)
+++ websites/staging/maven/trunk/content/extpaths.txt Mon Dec 10 08:17:24 2012
@@ -0,0 +1,401 @@
+# directories in /www/maven.apache.org/ but not in any svn tree: dtd, project, xsd
+# space indentation = directories not yet committed to svn production tree
+
+ant-tasks
+ant-tasks-2.0.10
+ant-tasks-2.1.2
+ant-tasks-2.1.3
+apache-resource-bundles
+archetype
+archetype-2.1
+archetype-2.2
+maven-archetype-bundles
+core-its
+enforcer
+jxr
+maven-1.x
+maven-indexer
+maven-release
+plugins/maven-acr-plugin
+plugins/maven-acr-plugin-1.0
+plugins/maven-ant-plugin
+plugins/maven-ant-plugin-2.1
+plugins/maven-ant-plugin-2.2
+plugins/maven-ant-plugin-2.3
+plugins/maven-antrun-plugin-latest
+plugins/maven-antrun-plugin-1.2
+plugins/maven-antrun-plugin-1.3
+plugins/maven-antrun-plugin-1.4
+plugins/maven-antrun-plugin-1.5
+plugins/maven-antrun-plugin-1.6
+plugins/maven-antrun-plugin-1.7
+plugins/maven-archetype-plugin
+plugins/maven-archetype-plugin-1.0-alpha-7
+plugins/maven-archetype-plugin-2.0-alpha-3
+plugins/maven-archetype-plugin-2.0-alpha-4
+plugins/maven-assembly-plugin
+plugins/maven-assembly-plugin-2.1
+plugins/maven-assembly-plugin-2.2
+plugins/maven-assembly-plugin-2.2.1
+plugins/maven-assembly-plugin-2.2.2
+plugins/maven-assembly-plugin-2.4
+plugins/maven-changelog-plugin
+plugins/maven-changelog-plugin-2.2
+plugins/maven-changes-plugin
+plugins/maven-changes-plugin-2.0
+plugins/maven-changes-plugin-2.1
+plugins/maven-changes-plugin-2.2
+plugins/maven-changes-plugin-2.3
+plugins/maven-changes-plugin-2.4
+plugins/maven-changes-plugin-2.5
+plugins/maven-changes-plugin-2.6
+plugins/maven-changes-plugin-2.7
+plugins/maven-changes-plugin-2.7.1
+plugins/maven-changes-plugin-2.8
+plugins/maven-checkstyle-plugin-latest
+plugins/maven-checkstyle-plugin-2.2
+plugins/maven-checkstyle-plugin-2.3
+plugins/maven-checkstyle-plugin-2.4
+plugins/maven-checkstyle-plugin-2.5
+plugins/maven-checkstyle-plugin-2.6
+plugins/maven-checkstyle-plugin-2.7
+plugins/maven-checkstyle-plugin-2.8
+plugins/maven-checkstyle-plugin-2.9
+plugins/maven-checkstyle-plugin-2.9.1
+plugins/maven-clean-plugin-latest
+plugins/maven-clean-plugin-2.3
+plugins/maven-clean-plugin-2.4
+plugins/maven-clean-plugin-2.4.1
+plugins/maven-clean-plugin-2.5
+plugins/maven-compiler-plugin
+plugins/maven-compiler-plugin-2.1
+plugins/maven-compiler-plugin-2.2
+plugins/maven-compiler-plugin-2.3.1
+plugins/maven-compiler-plugin-2.3.2
+plugins/maven-compiler-plugin-2.4
+plugins/maven-compiler-plugin-2.5
+plugins/maven-compiler-plugin-2.5.1
+plugins/maven-compiler-plugin-3.0
+plugins/maven-dependency-plugin
+plugins/maven-dependency-plugin-2.1
+plugins/maven-dependency-plugin-2.3
+plugins/maven-dependency-plugin-2.4
+plugins/maven-dependency-plugin-2.5
+plugins/maven-dependency-plugin-2.5.1
+plugins/maven-dependency-plugin-2.6
+plugins/maven-deploy-plugin
+plugins/maven-deploy-plugin-2.4
+plugins/maven-deploy-plugin-2.5
+plugins/maven-deploy-plugin-2.6
+plugins/maven-deploy-plugin-2.7
+plugins/maven-doap-plugin-latest
+plugins/maven-doap-plugin-1.0
+plugins/maven-doap-plugin-1.1
+plugins/maven-docck-plugin
+plugins/maven-docck-plugin-1.0
+plugins/maven-ear-plugin
+plugins/maven-ear-plugin-2.3.2
+plugins/maven-ear-plugin-2.4
+plugins/maven-ear-plugin-2.4.1
+plugins/maven-ear-plugin-2.4.2
+plugins/maven-ear-plugin-2.5
+plugins/maven-ear-plugin-2.6
+plugins/maven-ear-plugin-2.7
+plugins/maven-ear-plugin-2.8
+plugins/maven-eclipse-plugin
+plugins/maven-eclipse-plugin-2.4
+plugins/maven-eclipse-plugin-2.5
+plugins/maven-eclipse-plugin-2.5.1
+plugins/maven-eclipse-plugin-2.6
+plugins/maven-eclipse-plugin-2.7
+plugins/maven-eclipse-plugin-2.8
+plugins/maven-eclipse-plugin-2.9
+plugins/maven-ejb-plugin
+plugins/maven-ejb-plugin-2.2
+plugins/maven-ejb-plugin-2.2.1
+plugins/maven-ejb-plugin-2.3
+plugins/maven-enforcer-plugin
+plugins/maven-enforcer-plugin-1.0.1
+plugins/maven-enforcer-plugin-1.1
+plugins/maven-failsafe-plugin
+plugins/maven-failsafe-plugin-2.5
+plugins/maven-failsafe-plugin-2.6
+plugins/maven-failsafe-plugin-2.7
+plugins/maven-failsafe-plugin-2.7.1
+plugins/maven-failsafe-plugin-2.7.2
+plugins/maven-failsafe-plugin-2.8
+plugins/maven-failsafe-plugin-2.8.1
+plugins/maven-failsafe-plugin-2.9
+plugins/maven-failsafe-plugin-2.10
+plugins/maven-failsafe-plugin-2.11
+plugins/maven-failsafe-plugin-2.12
+plugins/maven-failsafe-plugin-2.12.1
+plugins/maven-failsafe-plugin-2.12.2
+plugins/maven-failsafe-plugin-2.12.3
+plugins/maven-failsafe-plugin-2.12.4
+plugins/maven-gpg-plugin
+plugins/maven-gpg-plugin-1.0
+plugins/maven-gpg-plugin-1.1
+plugins/maven-gpg-plugin-1.2
+plugins/maven-gpg-plugin-1.3
+plugins/maven-gpg-plugin-1.4
+plugins/maven-help-plugin
+plugins/maven-help-plugin-2.1
+plugins/maven-help-plugin-2.1.1
+plugins/maven-idea-plugin
+plugins/maven-idea-plugin-2.2
+plugins/maven-install-plugin
+plugins/maven-install-plugin-2.3
+plugins/maven-install-plugin-2.3.1
+plugins/maven-install-plugin-2.4
+plugins/maven-invoker-plugin
+plugins/maven-invoker-plugin-1.2.1
+plugins/maven-invoker-plugin-1.3
+plugins/maven-invoker-plugin-1.4
+plugins/maven-invoker-plugin-1.5
+plugins/maven-invoker-plugin-1.6
+plugins/maven-invoker-plugin-1.7
+plugins/maven-invoker-plugin-1.8
+plugins/maven-jar-plugin
+plugins/maven-jar-plugin-2.3
+plugins/maven-jar-plugin-2.3.1
+plugins/maven-jar-plugin-2.3.2
+plugins/maven-jar-plugin-2.4
+plugins/maven-jarsigner-plugin
+plugins/maven-jarsigner-plugin-1.0
+plugins/maven-jarsigner-plugin-1.1
+plugins/maven-jarsigner-plugin-1.2
+plugins/maven-javadoc-plugin
+plugins/maven-javadoc-plugin-2.5
+plugins/maven-javadoc-plugin-2.6
+plugins/maven-javadoc-plugin-2.6.1
+plugins/maven-javadoc-plugin-2.7
+plugins/maven-javadoc-plugin-2.8
+plugins/maven-javadoc-plugin-2.8.1
+plugins/maven-javadoc-plugin-2.9
+plugins/maven-jxr-plugin
+plugins/maven-jxr-plugin-2.2
+plugins/maven-linkcheck-plugin
+plugins/maven-linkcheck-plugin-1.0
+plugins/maven-linkcheck-plugin-1.0.1
+plugins/maven-linkcheck-plugin-1.1
+plugins/maven-one-plugin
+plugins/maven-patch-plugin
+plugins/maven-patch-plugin-1.1
+plugins/maven-patch-plugin-1.1.1
+plugins/maven-plugin-plugin
+plugins/maven-pdf-plugin
+plugins/maven-pdf-plugin-1.0
+plugins/maven-pdf-plugin-1.1
+plugins/maven-pdf-plugin-1.2
+plugins/maven-pmd-plugin-latest
+plugins/maven-pmd-plugin-2.5
+plugins/maven-pmd-plugin-2.6
+plugins/maven-pmd-plugin-2.7
+plugins/maven-pmd-plugin-2.7.1
+plugins/maven-project-info-reports-plugin
+plugins/maven-project-info-reports-plugin-2.1
+plugins/maven-project-info-reports-plugin-2.1.1
+plugins/maven-project-info-reports-plugin-2.1.2
+plugins/maven-project-info-reports-plugin-2.2
+plugins/maven-project-info-reports-plugin-2.3
+plugins/maven-project-info-reports-plugin-2.3.1
+plugins/maven-project-info-reports-plugin-2.4
+plugins/maven-project-info-reports-plugin-2.5
+plugins/maven-project-info-reports-plugin-2.5.1
+plugins/maven-project-info-reports-plugin-2.6
+plugins/maven-rar-plugin
+plugins/maven-rar-plugin-2.3
+plugins/maven-reactor-plugin
+plugins/maven-release-plugin-latest
+plugins/maven-release-plugin-2.0-beta-8
+plugins/maven-release-plugin-2.0-beta-9
+plugins/maven-release-plugin-2.0
+plugins/maven-release-plugin-2.1
+plugins/maven-release-plugin-2.2
+plugins/maven-release-plugin-2.2.1
+plugins/maven-release-plugin-2.2.2
+plugins/maven-release-plugin-2.3
+plugins/maven-release-plugin-2.3.1
+plugins/maven-release-plugin-2.3.2
+plugins/maven-remote-resources-plugin
+plugins/maven-remote-resources-plugin-1.1
+plugins/maven-remote-resources-plugin-1.2
+plugins/maven-remote-resources-plugin-1.2.1
+plugins/maven-remote-resources-plugin-1.3
+plugins/maven-remote-resources-plugin-1.4
+plugins/maven-repository-plugin
+plugins/maven-repository-plugin-2.3
+plugins/maven-repository-plugin-2.3.1
+plugins/maven-resources-plugin
+plugins/maven-resources-plugin-2.4.1
+plugins/maven-resources-plugin-2.4.2
+plugins/maven-resources-plugin-2.4.3
+plugins/maven-resources-plugin-2.5
+plugins/maven-resources-plugin-2.6
+plugins/maven-scm-publish-plugin
+plugins/maven-scm-publish-plugin-1.0-beta-1
+plugins/maven-scm-publish-plugin-1.0-beta-2
+plugins/maven-shade-plugin
+plugins/maven-shade-plugin-1.2.1
+plugins/maven-shade-plugin-1.2.2
+plugins/maven-shade-plugin-1.3
+plugins/maven-shade-plugin-1.3.1
+plugins/maven-shade-plugin-1.3.2
+plugins/maven-shade-plugin-1.3.3
+plugins/maven-shade-plugin-1.4
+plugins/maven-shade-plugin-1.5
+plugins/maven-shade-plugin-1.6
+plugins/maven-shade-plugin-1.7
+plugins/maven-shade-plugin-1.7.1
+plugins/maven-shade-plugin-2.0
+plugins/maven-site-plugin
+plugins/maven-site-plugin-2.0
+plugins/maven-site-plugin-2.0.1
+plugins/maven-site-plugin-2.1
+plugins/maven-site-plugin-2.1.1
+plugins/maven-site-plugin-2.2
+plugins/maven-site-plugin-2.3
+plugins/maven-site-plugin-2.4
+plugins/maven-site-plugin-3.0
+plugins/maven-site-plugin-3.1
+plugins/maven-site-plugin-3.2
+plugins/maven-source-plugin
+plugins/maven-source-plugin-2.1
+plugins/maven-source-plugin-2.1.1
+plugins/maven-source-plugin-2.1.2
+plugins/maven-source-plugin-2.2
+plugins/maven-stage-plugin
+plugins/maven-stage-plugin-1.0-alpha-2
+plugins/maven-surefire-plugin
+plugins/maven-surefire-plugin-2.5
+plugins/maven-surefire-plugin-2.6
+plugins/maven-surefire-plugin-2.7
+plugins/maven-surefire-plugin-2.7.1
+plugins/maven-surefire-plugin-2.7.2
+plugins/maven-surefire-plugin-2.8
+plugins/maven-surefire-plugin-2.8.1
+plugins/maven-surefire-plugin-2.9
+plugins/maven-surefire-plugin-2.10
+plugins/maven-surefire-plugin-2.11
+plugins/maven-surefire-plugin-2.12
+plugins/maven-surefire-plugin-2.12.1
+plugins/maven-surefire-plugin-2.12.2
+plugins/maven-surefire-plugin-2.12.3
+plugins/maven-surefire-plugin-2.12.4
+plugins/maven-surefire-report-plugin
+plugins/maven-surefire-report-plugin-2.5
+plugins/maven-surefire-report-plugin-2.6
+plugins/maven-surefire-report-plugin-2.7
+plugins/maven-surefire-report-plugin-2.7.1
+plugins/maven-surefire-report-plugin-2.7.2
+plugins/maven-surefire-report-plugin-2.8
+plugins/maven-surefire-report-plugin-2.9
+plugins/maven-surefire-report-plugin-2.10
+plugins/maven-surefire-report-plugin-2.11
+plugins/maven-surefire-report-plugin-2.12
+plugins/maven-surefire-report-plugin-2.12.1
+plugins/maven-surefire-report-plugin-2.12.2
+plugins/maven-surefire-report-plugin-2.12.3
+plugins/maven-toolchains-plugin
+plugins/maven-toolchains-plugin-1.0
+plugins/maven-verifier-plugin
+plugins/maven-verifier-plugin-1.0
+plugins/maven-war-plugin
+plugins/maven-war-plugin-2.1
+plugins/maven-war-plugin-2.1.1
+plugins/maven-war-plugin-2.2
+plugins/maven-war-plugin-2.3
+plugin-testing
+plugin-tools
+plugin-tools-3.0
+plugin-tools-3.1
+pom/asf
+pom/asf-10
+pom/asf-11
+pom/maven
+pom/maven-21
+pom/maven-plugins
+pom/maven-plugins-22
+pom/maven-plugins-23
+pom/maven-shared-components
+pom/maven-shared-components-17
+pom/maven-shared-components-18
+pom/skins
+ref
+sandbox
+scm
+shared/maven-archiver
+shared/maven-archiver-2.5
+shared/maven-artifact-resolver
+shared/maven-common-artifact-filters
+shared/maven-common-artifact-filters-1.4
+shared/maven-dependency-analyzer
+shared/maven-dependency-tree
+shared/maven-dependency-tree-1.2
+shared/maven-dependency-tree-2.0
+shared/maven-downloader
+shared/maven-doxia-tools
+shared/maven-doxia-tools-1.4
+shared/maven-enforcer-rule-api
+shared/maven-filtering
+shared/maven-filtering-1.0
+shared/maven-filtering-1.1
+shared/maven-dependency-analyzer-1.3
+shared/maven-shared-utils-0.1
+shared/maven-invoker
+shared/maven-invoker-2.1
+shared/maven-invoker-2.1.1
+shared/maven-invoker-2.0.11
+shared/maven-jarsigner
+shared/maven-shared-incremental
+shared/maven-model-converter
+shared/maven-osgi
+shared/maven-plugin-helper
+shared/maven-plugin-testing-harness
+shared/maven-plugin-testing-tools
+shared/maven-plugin-tools
+shared/maven-reporting-api
+shared/maven-reporting-api-3.0
+shared/maven-reporting-exec
+shared/maven-reporting-exec-1.0.2
+shared/maven-reporting-impl
+shared/maven-reporting-impl-2.2
+shared/maven-repository-builder
+shared/maven-runtime
+shared/maven-script-interpreter
+shared/maven-script-interpreter-1.1
+shared/maven-shared-io
+shared/maven-shared-jar
+shared/maven-shared-jar-1.1
+shared/maven-shared-resources
+shared/maven-shared-resources-1
+shared/maven-test-tools
+shared/maven-verifier
+shared/maven-verifier-1.3
+skins/maven-classic-skin-1.1
+skins/maven-fluido-skin-1.3.0
+skins/maven-fluido-skin-1.2.1
+skins/maven-fluido-skin-1.1
+skins/maven-fluido-skin-1.2.2
+skins/maven-fluido-skin-1.2
+skins/maven-default-skin-1.1
+skins/maven-classic-skin
+skins/maven-fluido-skin
+skins/maven-default-skin
+skins/maven-application-skin-1.0
+skins/maven-stylus-skin-1.1
+skins/maven-application-skin
+skins/maven-stylus-skin
+skins/maven-stylus-skin-1.4
+skins/maven-stylus-skin-1.5
+surefire
+surefire-2.10
+surefire-2.8.1
+surefire-2.9
+wagon
+wagon-1.0
+wagon-1.0-beta-7
+wagon-2.0
+wagon-2.1
+wagon-2.2
Added: websites/staging/maven/trunk/content/general.html
==============================================================================
--- websites/staging/maven/trunk/content/general.html (added)
+++ websites/staging/maven/trunk/content/general.html Mon Dec 10 08:17:24 2012
@@ -0,0 +1,567 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ | Generated by Apache Maven Doxia at Dec 10, 2012
+ | Rendered using Apache Maven Stylus Skin 1.5
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Maven - Frequently Asked Technical Questions</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta name="Date-Revision-yyyymmdd" content="20121210" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="./" id="bannerLeft">
+ <img src="images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="index.html">Maven</a>
+ >
+ Frequently Asked Technical Questions
+ </div>
+ <div class="xright">
+ Last Published: 2012-12-10
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Main</h5>
+ <ul>
+ <li class="none">
+ <a href="index.html">Welcome</a>
+ </li>
+ </ul>
+ <h5>Get Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="download.html">Download</a>
+ </li>
+ <li class="none">
+ <a href="docs/3.0.4/release-notes.html">Release Notes (3.0.4)</a>
+ </li>
+ <li class="none">
+ <a href="docs/2.2.1/release-notes.html">Release Notes (2.2.1)</a>
+ </li>
+ <li class="none">
+ <a href="docs/2.0.11/release-notes.html">Release Notes (2.0.11)</a>
+ </li>
+ <li class="none">
+ <a href="license.html">License</a>
+ </li>
+ </ul>
+ <h5>IDE Integration</h5>
+ <ul>
+ <li class="none">
+ <a href="eclipse-plugin.html">Eclipse</a>
+ </li>
+ <li class="none">
+ <a href="netbeans-module.html">NetBeans</a>
+ </li>
+ </ul>
+ <h5>About Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="what-is-maven.html">What is Maven?</a>
+ </li>
+ <li class="none">
+ <a href="maven-features.html">Features</a>
+ </li>
+ <li class="none">
+ <strong>FAQ (official)</strong>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/FAQs-1" class="externalLink">FAQ (unofficial)</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <a href="plugins/index.html">Maven Plugins</a>
+ </li>
+ <li class="none">
+ <a href="guides/index.html">Index (category)</a>
+ </li>
+ <li class="none">
+ <a href="run-maven/index.html">Running Maven</a>
+ </li>
+ <li class="collapsed">
+ <a href="users/index.html">User Centre</a>
+ </li>
+ <li class="collapsed">
+ <a href="plugin-developers/index.html">Plugin Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="repository/index.html">Maven Repository Centre</a>
+ </li>
+ <li class="none">
+ <a href="developers/index.html">Maven Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="articles.html">Books and Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/Home" class="externalLink">Wiki</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="community.html">Community Overview</a>
+ </li>
+ <li class="none">
+ <a href="guides/development/guide-helping.html">How to Contribute</a>
+ </li>
+ <li class="none">
+ <a href="guides/mini/guide-maven-evangelism.html">Maven Repository</a>
+ </li>
+ <li class="none">
+ <a href="users/getting-help.html">Getting Help</a>
+ </li>
+ <li class="none">
+ <a href="issue-tracking.html">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="source-repository.html">Source Repository</a>
+ </li>
+ <li class="none">
+ <a href="team-list.html">The Maven Team</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="project-info.html">Project Information</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="pom/index.html">Parent POMs</a>
+ </li>
+ <li class="none">
+ <a href="plugins/index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="plugin-tools/index.html">Plugin Tools</a>
+ </li>
+ <li class="none">
+ <a href="scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="skins/index.html">Skins</a>
+ </li>
+ <li class="none">
+ <a href="surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="./images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you 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. --><div class="section"><h2><a name="top">Frequently Asked Technical Questions</a><a name="Frequently_Asked_Technical_Questions"></a></h2><ol style="list-style-type: decimal"><li><a href="#encoding-warning">How do I prevent "[WARNING] Using platform encoding (Cp1252 actually) to copy filtered resources, i.e. build is platform dependent!"</a></li><li><a href="#scope-provided">How do I prevent including JARs in WEB-INF/lib? I need a "compile only" scope!</a></li><li><a href="#available-plugins">How do I list available plugins?</a></li><li><a href="#plugin-version">How do I determine what version of a plugin I am using?</a></li><li><a href="#using-ant-tasks">How can I use Ant tasks in a Maven build?</a></li><li><a href="#maven-ant-tasks">How can I use Maven features in an Ant build?</a></li><li><a href="#Compiling-J2SE-5">How do I set up Maven so it will compile with a target and source JVM of my choice?</a></li><li><a href="#dir-struct"
>Is it possible to create my own directory structure?</a></li><li><a href="#m2-source-code">Where is the source code? I couldn't seem to find a link anywhere on the Maven2 site.</a></li><li><a href="#proxy-needed">Maven can't seem to download the dependencies. Is my installation correct?</a></li><li><a href="#importing-jars">I have a jar that I want to put into my local repository. How can I copy it in?</a></li><li><a href="#unsubscribing-from-mailing-lists">How do I unsubscribe from Maven mailing lists?</a></li><li><a href="#skip-test">How do I skip the tests?</a></li><li><a href="#run-one-test">How can I run a single unit test?</a></li><li><a href="#special-characters-site">Handle special characters in site</a></li><li><a href="#tools-jar-dependency">How do I include <tt>tools.jar</tt> in my dependencies?</a></li><li><a href="#test-property-name">Maven compiles my test classes but doesn't run them?</a></li><li><a href="#snapshot-artifacts">Where are Maven SNAPSHOT artifact
s?</a></li><li><a href="#maven-xsd">Where are the Maven XSD schemas?</a></li><li><a href="#getting-help">Maven doesn't work, how do I get help?</a></li><li><a href="#How_to_produce_execution_debug_output_or_error_messages">How to produce execution debug output or error messages?</a></li><li><a href="#What_is_a_Mojo">What is a Mojo?</a></li><li><a href="#How_to_find_dependencies">How to find dependencies on public Maven repositories?</a></li></ol></div><dl><dt><a name="encoding-warning">How do I prevent "[WARNING] Using platform encoding (Cp1252 actually) to copy filtered resources, i.e. build is platform dependent!"</a></dt><dd>
+ <p>
+ This or a similar warning is emitted by a plugin that processes plain text files but has not been configured to
+ use a specific file encoding. So eliminating the warning is simply a matter of finding out what plugin emits it
+ and how to configure the file encoding for it. For plugins that follow our guideline for
+ <a class="externalLink" href="http://docs.codehaus.org/display/MAVENUSER/POM+Element+for+Source+File+Encoding">source file encoding</a>,
+ this is as easy as adding the following property to your POM (or one of its parent POMs):
+ </p>
+ <div class="source"><pre><project>
+ ...
+ <properties>
+ <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+ </properties>
+ ...
+</project></pre></div>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="scope-provided">How do I prevent including JARs in WEB-INF/lib? I need a "compile only" scope!</a></dt><dd>
+ <p>
+ The scope you should use for this is
+ <tt>provided</tt>. This indicates to Maven that the dependency will be
+ provided at run time by its container or the JDK, for example.
+ </p>
+ <p>
+ Dependencies with this scope will not be passed on transitively, nor will they be bundled in an package such
+ as a WAR, or included in the runtime classpath.
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="available-plugins">How do I list available plugins?</a></dt><dd>
+ <p>
+ The "Available Plugins" page lists them and provides additional information.
+ See <a class="externalLink" href="http://maven.apache.org/plugins/">http://maven.apache.org/plugins</a>
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="plugin-version">How do I determine what version of a plugin I am using?</a></dt><dd>
+ <p>
+ You can use the <a href="/plugins/maven-help-plugin/">Maven Help Plugin</a>'s
+ <a href="/plugins/maven-help-plugin/describe-mojo.html"><tt>describe</tt></a> goal.
+ For example, to find out the version of the install plugin:
+ </p>
+ <div class="source"><pre>mvn -Dplugin=install help:describe</pre></div>
+ <p>
+ Note that you must give the plugin prefix as the argument to plugin, not it's artifact ID.
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="using-ant-tasks">How can I use Ant tasks in a Maven build?</a></dt><dd>
+ <p>
+ There are currently 2 alternatives:
+ </p>
+ <ul>
+ <li>
+ For use in a plugin written in Java, Beanshell or other Java-like scripting language, you can construct
+ the Ant tasks using the
+ <a class="externalLink" href="http://ant.apache.org/manual/antexternal.html">instructions given in the Ant
+ documentation</a>
+ </li>
+ <li>
+ If you have very small amounts of Ant script specific to your project, you can use the
+ <a href="/plugins/maven-antrun-plugin/index.html">AntRun plugin</a>.
+ </li>
+ </ul>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="maven-ant-tasks">How can I use Maven features in an Ant build?</a></dt><dd>
+ <p>
+ The <a href="/ant-tasks/index.html">Maven Ant Tasks</a> allow many of the features of
+ Maven, such as dependency management and repository deployment, to be used in an Ant build.
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="Compiling-J2SE-5">How do I set up Maven so it will compile with a target and source JVM of my choice?</a></dt><dd>
+ <p>
+ You must configure the source and target parameters in your pom. For example, to set the source and
+ target JVM to 1.5, you should have in your pom:
+ </p>
+ <div class="source"><pre>
+ ...
+ <build>
+ ...
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-compiler-plugin</artifactId>
+ <version>2.3.2</version>
+ <configuration>
+ <source>1.5</source>
+ <target>1.5</target>
+ </configuration>
+ </plugin>
+ </plugins>
+ ...
+ </build>
+ ...</pre></div>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="dir-struct">Is it possible to create my own directory structure?</a></dt><dd>
+ <p>
+ Absolutely yes!
+ </p>
+ <p>
+ By configuring <sourceDirectory>, <resources> and other elements of
+ the <build> section.
+ </p>
+ <p>
+ In addition, you may need to change the plugin configuration if you are
+ not using plugin defaults for their files/directories.
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="m2-source-code">Where is the source code? I couldn't seem to find a link anywhere on the Maven2 site.</a></dt><dd>
+ <p>
+ The source code can be found in <a href="source-repository.html">our subversion repository</a>.
+ </p>
+ <p>
+ For more information, see <a href="/guides/development/guide-building-m2.html">Building Maven 2.0</a>.
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="proxy-needed">Maven can't seem to download the dependencies. Is my installation correct?</a></dt><dd>
+ <p>
+ You most probably need to configure Maven to use a proxy. Please see the information on
+ <a href="/guides/mini/guide-proxies.html">Configuring a proxy</a> for information on how to configure your proxy
+ for Maven.
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="importing-jars">I have a jar that I want to put into my local repository. How can I copy it in?</a></dt><dd>
+ <p>
+ If you understand the layout of the Maven repository, you can copy the jar directly into where it
+ is meant to go. Maven will find this file next time it is run.
+ </p>
+
+ <p>
+ If you are not confident about the layout of the Maven repository, then you can
+ adapt the following command to load in your jar file, all on one line.
+ </p>
+
+ <div class="source"><pre>
+mvn install:install-file
+ -Dfile=<path-to-file>
+ -DgroupId=<group-id>
+ -DartifactId=<artifact-id>
+ -Dversion=<version>
+ -Dpackaging=<packaging>
+ -DgeneratePom=true
+
+Where: <path-to-file> the path to the file to load
+ <group-id> the group that the file should be registered under
+ <artifact-id> the artifact name for the file
+ <version> the version of the file
+ <packaging> the packaging of the file e.g. jar
+ </pre></div>
+ <p>
+ This should load in the file into the Maven repository, renaming it as needed.
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="unsubscribing-from-mailing-lists">How do I unsubscribe from Maven mailing lists?</a></dt><dd>
+ <p>
+ To unsubscribe from a Maven mailing list you simply send a message to
+ </p><div class="source"><pre>[mailing-list]-unsubscribe@maven.apache.org</pre></div>
+
+ <p>
+ So, if you have subscribed to <tt>users@maven.apache.org</tt> then you would
+ send a message to <tt>users-unsubscribe@maven.apache.org</tt> in order to
+ get off the list.
+ People tend to have problems when they subscribe with one address and
+ attempt to unsubscribe with another. So make sure that you are using the
+ same address when unsubscribing that you used to subscribe before
+ asking for help.
+ </p>
+ <p>
+ If you find you still cannot get off a list then
+ send a message to <tt>[mailing-list]-help@maven.apache.org</tt>. These
+ instructions are also appended to every message sent out on a maven mailing
+ list ...
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="skip-test">How do I skip the tests?</a></dt><dd>
+ Add the parameter <tt>-Dmaven.test.skip=true</tt> or <tt>-DskipTests=true</tt> in the command line,
+ depending on whether you want to skip test compilation and execution or only execution. See the example
+ <a href="/plugins/maven-surefire-plugin/examples/skipping-test.html">Skipping Tests</a>
+ in the Surefire Plugin's documentation for more details.
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="run-one-test">How can I run a single unit test?</a></dt><dd>
+ Use the parameter <tt>-Dtest=MyTest</tt> at the command line.
+ NB: do not specify the entire package (org.apache.x.y.MyTest)
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="special-characters-site">Handle special characters in site</a></dt><dd>
+ <p>Configure your ide to use the correct encoding. With eclipse, add
+ <tt>-Dfile.encoding=ISO-8859-1</tt> in eclipse.ini file</p>
+ <p>Configure the output encoding in your pom
+ </p><div class="source"><pre>
+ ...
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-site-plugin</artifactId>
+ <version>2.3</version>
+ <configuration>
+ <outputEncoding>UTF-8</outputEncoding>
+ </configuration>
+ </plugin>
+ ...</pre></div>
+
+ <p>
+ Configure the file encoding use by mvn.
+ add to MAVEN_OPTS the encoding (same as the ide).
+ This can be made with adding <tt>MAVEN_OPTS="-Dfile.encoding=ISO-8859-1"</tt> in $HOME/.profile
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="tools-jar-dependency">How do I include <tt>tools.jar</tt> in my dependencies?</a></dt><dd>
+ <p>
+ The following code includes <tt>tools.jar</tt> for JDKs on Windows, Linux and Solaris (it is already
+ included in the runtime for Mac OS X and some free JDKs).
+ </p>
+ <div class="source"><pre>
+...
+ <profiles>
+ <profile>
+ <id>default-tools.jar</id>
+ <activation>
+ <property>
+ <name>java.vendor</name>
+ <value>Sun Microsystems Inc.</value>
+ </property>
+ </activation>
+ <dependencies>
+ <dependency>
+ <groupId>com.sun</groupId>
+ <artifactId>tools</artifactId>
+ <version>1.4.2</version>
+ <scope>system</scope>
+ <systemPath>${java.home}/../lib/tools.jar</systemPath>
+ </dependency>
+ </dependencies>
+ </profile>
+ </profiles>
+ ...</pre></div>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="test-property-name">Maven compiles my test classes but doesn't run them?</a></dt><dd>
+ <p>
+ Tests are run by the surefire plugin. The surefire plugin can be configured to run certain test classes and
+ you may have unintentionally done so by specifying a value to ${test}.
+
+ Check your settings.xml and pom.xml for a property named "test" which would like this:
+ </p>
+ <div class="source"><pre>
+ ...
+ <properties>
+ <property>
+ <name>test</name>
+ <value>some-value</value>
+ </property>
+ </properties>
+ ...</pre></div>
+ <p>
+ or
+ </p>
+ <div class="source"><pre>
+ ...
+ <properties>
+ <test>some-value</test>
+ </properties>
+ ...</pre></div>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="snapshot-artifacts">Where are Maven SNAPSHOT artifacts?</a></dt><dd>
+ <p>
+ If you are trying to build a development version of Maven or plugins,
+ you may need to access the maven snapshot repositories.
+ </p>
+
+ <p>
+ You need to update your settings.xml file using the
+ <a href="/guides/development/guide-testing-development-plugins.html">
+ Guide to Plugin Snapshot Repositories</a>
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="maven-xsd">Where are the Maven XSD schemas?</a></dt><dd>
+ <p>
+ The Maven XSD is located <a href="/xsd/maven-4.0.0.xsd">here</a> and the Maven
+ Settings XSD is located <a href="/xsd/settings-1.0.0.xsd">here</a>.
+ </p>
+ <p>
+ Your favorite IDE probably supports XSD schema's for pom.xml and settings.xml editing. You need to
+ specify the following:
+ </p><div class="source"><pre>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
+ http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+ ...
+</project></pre></div>
+ <div class="source"><pre>
+<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
+ ...
+</settings></pre></div>
+
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="getting-help">Maven doesn't work, how do I get help?</a></dt><dd>
+ <p>
+ We have compiled a list of available resources on the
+ <a href="/users/getting-help.html">getting help page</a>
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="How_to_produce_execution_debug_output_or_error_messages">How to produce execution debug output or error messages?</a></dt><dd>
+ <p>
+ You could call Maven with <i>-X</i> parameter or <i>-e</i> parameter. For more information,
+ run:
+ </p><div class="source"><pre>mvn --help</pre></div>
+
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="What_is_a_Mojo">What is a Mojo?</a></dt><dd>
+ <p>
+ A mojo is a <b>M</b>aven plain <b>O</b>ld <b>J</b>ava <b>O</b>bject. Each mojo is an executable
+ <i>goal</i> in Maven, and a plugin is a distribution of one or more related mojos.
+ </p>
+ <p align="right"><a href="#top">[top]</a></p><hr /></dd><dt><a name="How_to_find_dependencies">How to find dependencies on public Maven repositories?</a></dt><dd>
+ <p>
+ You could use the following search engines:
+ </p>
+ <ul>
+ <li><a class="externalLink" href="http://search.maven.org/">http://search.maven.org</a></li>
+ <li><a class="externalLink" href="http://repository.apache.org">http://repository.apache.org</a></li>
+ <li><a class="externalLink" href="http://www.artifact-repository.org/">http://www.artifact-repository.org</a></li>
+ <li><a class="externalLink" href="http://mvnrepository.com">http://mvnrepository.com</a></li>
+ <li><a class="externalLink" href="http://www.mvnbrowser.com">http://www.mvnbrowser.com</a></li>
+ <li><a class="externalLink" href="http://www.jarvana.com">http://www.jarvana.com</a></li>
+ </ul>
+ <p align="right"><a href="#top">[top]</a></p></dd></dl>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2012
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/maven/trunk/content/glossary.html
==============================================================================
--- websites/staging/maven/trunk/content/glossary.html (added)
+++ websites/staging/maven/trunk/content/glossary.html Mon Dec 10 08:17:24 2012
@@ -0,0 +1,250 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ | Generated by Apache Maven Doxia at Dec 10, 2012
+ | Rendered using Apache Maven Stylus Skin 1.5
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Maven - Maven Getting Started Guide</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Jason van Zyl" />
+ <meta name="Date-Revision-yyyymmdd" content="20121210" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="./" id="bannerLeft">
+ <img src="images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="index.html">Maven</a>
+ >
+ Maven Getting Started Guide
+ </div>
+ <div class="xright">
+ Last Published: 2012-12-10
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Main</h5>
+ <ul>
+ <li class="none">
+ <a href="index.html">Welcome</a>
+ </li>
+ </ul>
+ <h5>Get Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="download.html">Download</a>
+ </li>
+ <li class="none">
+ <a href="docs/3.0.4/release-notes.html">Release Notes (3.0.4)</a>
+ </li>
+ <li class="none">
+ <a href="docs/2.2.1/release-notes.html">Release Notes (2.2.1)</a>
+ </li>
+ <li class="none">
+ <a href="docs/2.0.11/release-notes.html">Release Notes (2.0.11)</a>
+ </li>
+ <li class="none">
+ <a href="license.html">License</a>
+ </li>
+ </ul>
+ <h5>IDE Integration</h5>
+ <ul>
+ <li class="none">
+ <a href="eclipse-plugin.html">Eclipse</a>
+ </li>
+ <li class="none">
+ <a href="netbeans-module.html">NetBeans</a>
+ </li>
+ </ul>
+ <h5>About Maven</h5>
+ <ul>
+ <li class="none">
+ <a href="what-is-maven.html">What is Maven?</a>
+ </li>
+ <li class="none">
+ <a href="maven-features.html">Features</a>
+ </li>
+ <li class="none">
+ <a href="general.html">FAQ (official)</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/FAQs-1" class="externalLink">FAQ (unofficial)</a>
+ </li>
+ </ul>
+ <h5>Documentation</h5>
+ <ul>
+ <li class="none">
+ <a href="plugins/index.html">Maven Plugins</a>
+ </li>
+ <li class="none">
+ <a href="guides/index.html">Index (category)</a>
+ </li>
+ <li class="none">
+ <a href="run-maven/index.html">Running Maven</a>
+ </li>
+ <li class="collapsed">
+ <a href="users/index.html">User Centre</a>
+ </li>
+ <li class="collapsed">
+ <a href="plugin-developers/index.html">Plugin Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="repository/index.html">Maven Repository Centre</a>
+ </li>
+ <li class="none">
+ <a href="developers/index.html">Maven Developer Centre</a>
+ </li>
+ <li class="none">
+ <a href="articles.html">Books and Resources</a>
+ </li>
+ <li class="none">
+ <a href="http://docs.codehaus.org/display/MAVENUSER/Home" class="externalLink">Wiki</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="community.html">Community Overview</a>
+ </li>
+ <li class="none">
+ <a href="guides/development/guide-helping.html">How to Contribute</a>
+ </li>
+ <li class="none">
+ <a href="guides/mini/guide-maven-evangelism.html">Maven Repository</a>
+ </li>
+ <li class="none">
+ <a href="users/getting-help.html">Getting Help</a>
+ </li>
+ <li class="none">
+ <a href="issue-tracking.html">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="source-repository.html">Source Repository</a>
+ </li>
+ <li class="none">
+ <a href="team-list.html">The Maven Team</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="project-info.html">Project Information</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="pom/index.html">Parent POMs</a>
+ </li>
+ <li class="none">
+ <a href="plugins/index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="plugin-tools/index.html">Plugin Tools</a>
+ </li>
+ <li class="none">
+ <a href="scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="skins/index.html">Skins</a>
+ </li>
+ <li class="none">
+ <a href="surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="./images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <div class="section"><h2>Glossary<a name="Glossary"></a></h2><p>This document describes some of the most common terms encountered while using Maven. These terms, that have an explicit meaning for Maven, can sometimes be confusing for newcomers.</p><ul><li><a name="Project"><b>Project</b></a>: Maven thinks in terms of projects. Everything that you will build are projects. Those projects follow a well defined "Project Object Model". Projects can depend on other projects, in which case the latter are called "dependencies". A project may consistent of several subprojects, however these subprojects are still treated equally as projects.</li><li><a name="Project_Object_Model_POM"><b>Project Object Model (POM)</b></a>: The Project Object Model, almost always referred as the POM for brevity, is the metadata that Maven needs to work with your project. Its name is "project.xml" and it is located in the root directory of each project.</li><li><a na
me="Artifact"><b>Artifact</b></a>: An artifact is something that is either produced or used by a project. Examples of artifacts produced by Maven for a project include: JARs, source and binary distributions, WARs. Each artifact is uniquely identified by a <a href="#GroupId">group id</a> and an artifact ID which is unique within a group.</li><li><a name="GroupId"><b>GroupId</b></a>: A group ID is a universally unique identifier for a project. While this is often just the project name (eg. <tt>commons-collections</tt>), it is helpful to use a fully-qualified package name to distinguish it from other projects with a similar name (eg. <tt>org.apache.maven</tt>).</li><li><a name="Dependency"><b>Dependency</b></a>: A typical Java project relies on libraries to build and/or run. Those are called "dependencies" inside Maven. Those dependencies are usually other projects' JAR artifacts, but are referenced by the POM that describes them.</li><li><a name="Plug-in"><b>Plug-in<
/b></a>: Maven is organized in plugins. Every piece of functionality in Maven is provided by a plugin. Plugins provide goals and use the metadata found in the POM to perform their task. Examples of plugins are: jar, eclipse, war. Plugins are primarily written in Java, but Maven also supports writing plug-ins in Beanshell and Ant Scripting.</li><li><a name="Mojo"><b>Mojo</b></a>: A plugin written in Java consists of one or more mojos. A mojo is a Java class that implements the org.apache.maven.plugin.Mojo interface. This means that a mojo is the implementation for a goal in a plugin.</li></ul><!-- * {<<Goal>>}: and phases --><!-- Goals are what are executed to perform an action on the project. For example, the --><!-- <<<jar:jar>>> will compile the current project and produce a JAR. --><!-- Each goal exists in a plugin (except for those that you define yourself), and the --><!-- goal name usually reflects the plugin (eg. <<<java:compile>>> comes from the --><!-- <<<java>>> pl
ugin). --><ul><li><a name="Repository"><b>Repository</b></a>:<p>Refer to <a href="./guides/introduction/introduction-to-repositories.html">Introduction to Repositories</a></p></li><li><a name="Snapshots"><b>Snapshots</b></a>: Projects can (and should) have a special version including <tt>SNAPSHOT</tt> to indicate that they are a "work in progress", and are not yet released. When a snapshot dependency is encountered, it is always looked for in all remote repositories, and downloaded again if newer than the local copy.<p>The version can either be the string <tt>SNAPSHOT</tt> itself, indicating "the very latest" development version, or something like <tt>1.1-SNAPSHOT</tt>, indicating development that will be released as 1.1 (i.e. newer than 1.0, but not yet 1.1).</p></li><li><a name="APT"><b>APT</b></a>: APT is a wiki-like format of documentation that Maven currently understands.<p>For information on how to create APT files, refer to the <a href="./guides/mi
ni/guide-site.html">Guide to creating a site</a> document.</p></li><li><a name="XDoc"><b>XDoc</b></a>: XDoc is the format of documentation that Maven currently understands. It is quite simple, and allows embedding XHTML within a simple layout that is transformed into a uniform site.<p>For information on how to create XDoc files, refer to the <a href="./guides/mini/guide-site.html">Guide to creating a site</a> document.</p></li></ul></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2012
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: websites/staging/maven/trunk/content/guides/MavenQuickReferenceCard.pdf
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/maven/trunk/content/guides/MavenQuickReferenceCard.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf