You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by hb...@apache.org on 2011/07/10 01:28:40 UTC
svn commit: r1144762 - in /maven/site/trunk/src/site/fml: about.fml
general.fml maven1.fml project-faq.fml
Author: hboutemy
Date: Sat Jul 9 23:28:39 2011
New Revision: 1144762
URL: http://svn.apache.org/viewvc?rev=1144762&view=rev
Log:
updated FAQs for Maven 3
Modified:
maven/site/trunk/src/site/fml/about.fml
maven/site/trunk/src/site/fml/general.fml
maven/site/trunk/src/site/fml/maven1.fml
maven/site/trunk/src/site/fml/project-faq.fml
Modified: maven/site/trunk/src/site/fml/about.fml
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/fml/about.fml?rev=1144762&r1=1144761&r2=1144762&view=diff
==============================================================================
--- maven/site/trunk/src/site/fml/about.fml (original)
+++ maven/site/trunk/src/site/fml/about.fml Sat Jul 9 23:28:39 2011
@@ -46,6 +46,21 @@
</answer>
</faq>
+ <faq id="m3-goals">
+ <question>Tell me about the goals of Maven 3.0</question>
+ <answer>
+ <p>
+ Maven 3.0 is an important internal improvement with following goals:
+ </p>
+ <ul>
+ <li>Backward compatibility</li>
+ <li>Performance improvement</li>
+ <li>Parallel builds</li>
+ <li>Better error and integrity reporting</li>
+ </ul>
+ </answer>
+ </faq>
+
<faq id="get-involved">
<question>Can I get involved?</question>
<answer>
@@ -58,8 +73,8 @@
join the project.
</p>
<p>
- For instructions on checking out and building Maven 2.0, see
- <a href="./guides/development/guide-building-m2.html">Building Maven 2.0</a>
+ For instructions on checking out and building Maven 2 and 3, see
+ <a href="./guides/development/guide-building-m2.html">Building Maven</a>
.
</p>
<p>
@@ -102,10 +117,10 @@
</faq>
<faq id="get-help">
- <question>Where do I get help with Maven 2.0?</question>
+ <question>Where do I get help with Maven 2 & 3?</question>
<answer>
<p>
- Help for both Maven 1.0 and Maven 2.0 can be obtained by subscribing and posting to the
+ Help for both Maven 1.0 and Maven 2 & 3 can be obtained by subscribing and posting to the
<a href="http://maven.apache.org/mail-lists.html">Maven Users List</a>.
</p>
<p>
Modified: maven/site/trunk/src/site/fml/general.fml
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/fml/general.fml?rev=1144762&r1=1144761&r2=1144762&view=diff
==============================================================================
--- maven/site/trunk/src/site/fml/general.fml (original)
+++ maven/site/trunk/src/site/fml/general.fml Sat Jul 9 23:28:39 2011
@@ -62,8 +62,7 @@
<question>How do I list available plugins?</question>
<answer>
<p>
- The "Available Plugins" page lists them,
- and provides additional information to browse the Maven 2 repository.
+ The "Available Plugins" page lists them and provides additional information.
See <a href="http://maven.apache.org/plugins/">http://maven.apache.org/plugins</a>
</p>
</answer>
@@ -73,8 +72,9 @@
<question>How do I determine what version of a plugin I am using?</question>
<answer>
<p>
- You can use the Maven Help Plugin's <code>describe</code> goal. For example, to find out the version
- of the install plugin:
+ You can use the <a href="/plugins/maven-help-plugin/">Maven Help Plugin</a>'s
+ <a href="/plugins/maven-help-plugin/describe-mojo.html"><code>describe</code></a> goal.
+ For example, to find out the version of the install plugin:
</p>
<source>mvn -Dplugin=install help:describe</source>
<p>
@@ -98,7 +98,7 @@
</li>
<li>
If you have very small amounts of Ant script specific to your project, you can use the
- <a href="http://maven.apache.org/plugins/maven-antrun-plugin/index.html">AntRun plugin</a>.
+ <a href="/plugins/maven-antrun-plugin/index.html">AntRun plugin</a>.
</li>
</ul>
</answer>
@@ -108,7 +108,7 @@
<question>How can I use Maven features in an Ant build?</question>
<answer>
<p>
- The <a href="http://maven.apache.org/ant-tasks/index.html">Maven Ant Tasks</a> allow many of the features of
+ 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>
</answer>
@@ -129,7 +129,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
- <version>2.0.2</version>
+ <version>2.3.2</version>
<configuration>
<source>1.5</source>
<target>1.5</target>
@@ -166,7 +166,7 @@
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>.
+ For more information, see <a href="/guides/development/guide-building-m2.html">Building Maven 2.0</a>.
</p>
</answer>
</faq>
@@ -176,7 +176,7 @@
<answer>
<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
+ <a href="/guides/mini/guide-proxies.html">Configuring a proxy</a> for information on how to configure your proxy
for Maven.
</p>
</answer>
@@ -186,12 +186,12 @@
<question>I have a jar that I want to put into my local repository. How can I copy it in?</question>
<answer>
<p>
- If you understand the layout of the maven repository, you can copy the jar directly into where it
+ 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
+ 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>
@@ -211,7 +211,7 @@ Where: <path-to-file> the path to the f
<packaging> the packaging of the file e.g. jar
]]></source>
<p>
- This should load in the file into the maven repository, renaming it as needed.
+ This should load in the file into the Maven repository, renaming it as needed.
</p>
</answer>
</faq>
@@ -246,7 +246,7 @@ Where: <path-to-file> the path to the f
<answer>
Add the parameter <code>-Dmaven.test.skip=true</code> or <code>-DskipTests=true</code> in the command line,
depending on whether you want to skip test compilation and execution or only execution. See the example
- <a href="http://maven.apache.org/plugins/maven-surefire-plugin/examples/skipping-test.html">Skipping Tests</a>
+ <a href="/plugins/maven-surefire-plugin/examples/skipping-test.html">Skipping Tests</a>
in the Surefire Plugin's documentation for more details.
</answer>
</faq>
@@ -270,7 +270,7 @@ Where: <path-to-file> the path to the f
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId>
- <version>2.0-beta-6</version>
+ <version>2.3</version>
<configuration>
<outputEncoding>UTF-8</outputEncoding>
</configuration>
@@ -358,7 +358,7 @@ Where: <path-to-file> the path to the f
<p>
You need to update your settings.xml file using the
- <a href="guides/development/guide-testing-development-plugins.html">
+ <a href="/guides/development/guide-testing-development-plugins.html">
Guide to Plugin Snapshot Repositories</a>
</p>
</answer>
@@ -368,8 +368,8 @@ Where: <path-to-file> the path to the f
<question>Where are the Maven XSD schemas?</question>
<answer>
<p>
- The Maven XSD is located <a href="http://maven.apache.org/xsd/maven-4.0.0.xsd">here</a> and the Maven
- Settings XSD is located <a href="http://maven.apache.org/xsd/settings-1.0.0.xsd">here</a>.
+ 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
@@ -398,7 +398,7 @@ Where: <path-to-file> the path to the f
<answer>
<p>
We have compiled a list of available resources on the
- <a href="users/getting-help.html">getting help page</a>
+ <a href="/users/getting-help.html">getting help page</a>
</p>
</answer>
</faq>
Modified: maven/site/trunk/src/site/fml/maven1.fml
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/fml/maven1.fml?rev=1144762&r1=1144761&r2=1144762&view=diff
==============================================================================
--- maven/site/trunk/src/site/fml/maven1.fml (original)
+++ maven/site/trunk/src/site/fml/maven1.fml Sat Jul 9 23:28:39 2011
@@ -27,7 +27,7 @@
<question>What's Changed?</question>
<answer>
<p>
- Maven 2.0 will feel very different to a Maven 1.0 user - and perhaps a little strange. But it is a lot simpler
+ Maven 2.0 & 3.0 will feel very different to a Maven 1.0 user - and perhaps a little strange. But it is a lot simpler
to work with and closer to how Maven was always meant to be! The key changes from Maven 1.0 are:
</p>
<ul>
@@ -38,19 +38,9 @@
</li>
<li>
<i>Defined build lifecycle</i>
- - No more
- <code>prereqs</code>
- ,
- <code>preGoals</code>
- and
- <code>postGoals</code>
- .
+ - No more <code>prereqs</code>, <code>preGoals</code> and <code>postGoals</code>.
The build is a series of well defined phases. This also means that the normal goal names are not used -
- <code>compile</code>
- ,
- <code>test</code>
- and
- <code>install</code>
+ <code>compile</code>, <code>test</code> and <code>install</code>
work for any project type.
</li>
<li>
@@ -59,24 +49,17 @@
results.
</li>
<li>
- <i>Improved
- <code>SNAPSHOT</code>
- handling
- </i>
+ <i>Improved <code>SNAPSHOT</code> handling</i>
- Snapshots are now checked for updates only once per day by
default - though can be configured to be once per build, on a particular interval, or never. A command line
option can force a check - making it more like updating from an SCM.
</li>
<li>
<i>No more properties files</i>
- - All plugins are now configured from the POM (which is now called
- <code>pom.xml</code>
- ).
+ - All plugins are now configured from the POM (which is now called <code>pom.xml</code>).
</li>
<li>
- <i>No more
- <code>maven.xml</code>
- </i>
+ <i>No more <code>maven.xml</code></i>
- Plugins are now easier to build and integrate, and are the only way
to script your builds. (Note that additions may later be made to the POM to allow simple things that
scripting
@@ -88,20 +71,20 @@
</li>
<li>
<i>Improved repository layout</i>
- - Maven 2.0 supports both the existing layout, and an improved repository
+ - Maven 2.0 supports both the existing layout (not Maven 3), and an improved repository
layout that has deeper, partitioned structure making it easier to browse.
</li>
</ul>
</answer>
</faq>
<faq id="m1-or-m2">
- <question>Should I use Maven 2.0, or Maven 1.0?</question>
+ <question>Should I use Maven 2.x, Maven 3.x, or Maven 1.0?</question>
<answer>
<p>
- Maven 2.0 is the latest stable release, and we certainly recommend it for all new projects.
+ Maven 3.x is the latest stable release, and we certainly recommend it for all new projects.
</p>
<p>
- If you are already using Maven 1.0 - you should try out Maven 2.0, as it is very much improved.
+ If you are already using Maven 1.0 - you should try out Maven 3.x, as it is very much improved.
However, we still continue to support the Maven 1.x releases at this time.
</p>
<p>
@@ -111,14 +94,13 @@
listed. These will make your project a lot easier to migrate in the future.
</p>
<p>
- The following are the known limitations in the current Maven 2.0 release compared to Maven 1.x:
+ The following are the known limitations in the current Maven 2.x release compared to Maven 1.x: none.
+ </p>
+ <p>
+ The following are the known limitations in the current Maven 3.x release compared to Maven 1.x:
</p>
<ul>
- <li>
- <i>Availability of plugins</i>
- - While most of the core Maven 1.x plugins have been converted,
- several 3rd party plugins may not be available. Maven 2.0 cannot execute Maven 1.0 plugins.
- </li>
+ <li>Maven 1 repository layout is not supported</li>
</ul>
</answer>
</faq>
@@ -179,11 +161,11 @@
</answer>
</faq>
<faq id="convert">
- <question>How do I convert from Maven 1.x to Maven 2.x?</question>
+ <question>How do I convert from Maven 1.x to Maven 2.x or 3.x?</question>
<answer>
- This is discussed in <a href="http://maven.apache.org/guides/mini/guide-m1-m2.html">Guide to Moving from Maven 1.x to Maven 2.x</a>.
+ This is discussed in <a href="http://maven.apache.org/guides/mini/guide-m1-m2.html">Guide to Moving from Maven 1.x to Maven 2.x</a>
+ (Maven 3.x is mostly equivalent to Maven 2.x).
</answer>
</faq>
</part>
</faqs>
-
Modified: maven/site/trunk/src/site/fml/project-faq.fml
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/fml/project-faq.fml?rev=1144762&r1=1144761&r2=1144762&view=diff
==============================================================================
--- maven/site/trunk/src/site/fml/project-faq.fml (original)
+++ maven/site/trunk/src/site/fml/project-faq.fml Sat Jul 9 23:28:39 2011
@@ -61,8 +61,7 @@
<p>
It is best to get it right at the time of a release to avoid having to make difficult updates later on.
Your information can be submitted to Maven using the regular
- <a href="guides/mini/guide-central-repository-upload.html">repository upload procedure</a>
- .
+ <a href="/guides/mini/guide-central-repository-upload.html">repository upload procedure</a>.
</p>
<p>
The following information is what is best to provide: