You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by el...@apache.org on 2020/03/18 13:54:55 UTC
[maven-site] branch 1 created (now e202c25)
This is an automated email from the ASF dual-hosted git repository.
elharo pushed a change to branch 1
in repository https://gitbox.apache.org/repos/asf/maven-site.git.
at e202c25 clear out a lot fo old and obsolete Maven 1.x and 2.x content
This branch includes the following new commits:
new e202c25 clear out a lot fo old and obsolete Maven 1.x and 2.x content
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
[maven-site] 01/01: clear out a lot fo old and obsolete Maven 1.x
and 2.x content
Posted by el...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
elharo pushed a commit to branch 1
in repository https://gitbox.apache.org/repos/asf/maven-site.git
commit e202c2535897d0e7db17bfb5465447590658ffde
Author: Elliotte Rusty Harold <el...@ibiblio.org>
AuthorDate: Wed Mar 18 09:54:32 2020 -0400
clear out a lot fo old and obsolete Maven 1.x and 2.x content
---
content/apt/guides/getting-started/index.apt | 7 +-
content/apt/guides/mini/guide-site.apt | 4 +-
content/fml/about.fml | 38 +-----
content/fml/maven1.fml | 171 ------------------------
content/markdown/faq-unoffical.md | 165 ++++-------------------
content/xdoc/docs-required.xml | 192 ---------------------------
6 files changed, 33 insertions(+), 544 deletions(-)
diff --git a/content/apt/guides/getting-started/index.apt b/content/apt/guides/getting-started/index.apt
index 9218f0a..5361b38 100644
--- a/content/apt/guides/getting-started/index.apt
+++ b/content/apt/guides/getting-started/index.apt
@@ -482,9 +482,6 @@ mvn clean
Whenever you want to customise the build for a Maven project, this is done by adding or reconfiguring plugins.
- <<Note for Maven 1.0 Users:>> In Maven 1.0, you would have added some <<<preGoal>>> to <<<maven.xml>>>
- and some entries to <<<project.properties>>>. Here, it is a little different.
-
For this example, we will configure the Java compiler to allow JDK 5.0 sources. This is as simple as
adding this to your POM:
@@ -1245,6 +1242,6 @@ $ jar tvf my-webapp/target/my-webapp-1.0-SNAPSHOT.war
reason for this is the <<<\<scope\>test\</scope\>>>> element - it is only required for testing,
and so is not included in the web application as the compile time dependency <<<my-app>>> is.
- The final step was to include a parent definition. This is different to the <<<extend>>> element you
- may be familiar with from Maven 1.0: this ensures that the POM can always be located even if the project
+ The final step was to include a parent definition.
+ This ensures that the POM can always be located even if the project
is distributed separately from its parent by looking it up in the repository.
\ No newline at end of file
diff --git a/content/apt/guides/mini/guide-site.apt b/content/apt/guides/mini/guide-site.apt
index dc375ed..a8f916d 100644
--- a/content/apt/guides/mini/guide-site.apt
+++ b/content/apt/guides/mini/guide-site.apt
@@ -125,9 +125,7 @@ mvn site-deploy
* Creating a Site Descriptor
- The <<<site.xml>>> file is used to describe the layout of the site, and
- replaces the <<<navigation.xml>>> file used in Maven 1.x.
-
+ The <<<site.xml>>> file is used to describe the layout of the site.
A sample is given below:
--------------------
diff --git a/content/fml/about.fml b/content/fml/about.fml
index 2cc08c3..8df9480 100644
--- a/content/fml/about.fml
+++ b/content/fml/about.fml
@@ -21,30 +21,8 @@
<faqs xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://maven.apache.org/FML/1.0"
xsi:schemaLocation="http://maven.apache.org/FML/1.0 https://maven.apache.org/xsd/fml-1.0.xsd"
- title="About Maven 2.0">
+ title="About Maven">
<part id="about">
- <faq id="m2-goals">
- <question>Tell me about the goals of Maven 2.0</question>
- <answer>
- <p>
- In addition to understanding the
- <a href="./what-is-maven.html">Goals of Maven</a>
- there have also been questions about why Maven 2.0 is rewritten from the successful Maven 1.0.
- In summary, the main goals of the new Maven 2.0 architecture are:
- </p>
- <ul>
- <li>To be simple to use - it should be more obvious and consistent about how things are working</li>
- <li>Fast - a new architecture and smaller memory footprint make it as fast as possible</li>
- <li>To be able to implement the features demanded were not possible under the Maven 1.0 architecture</li>
- </ul>
- <p>
- Unfortunately, to reach these goals we've had to sacrifice backwards compatibility. Instead of
- making many small incremental changes that would break compatibility often over time, we decided to build on a
- new, solid base that can be reliable for the future, and also to maintain the existing Maven 1.x product to
- ensure that existing users are not left out in the cold.
- </p>
- </answer>
- </faq>
<faq id="m3-goals">
<question>Tell me about the goals of Maven 3.0</question>
@@ -86,25 +64,19 @@
</faq>
<faq id="scripting-languages">
- <question>What plugin languages will Maven 2.0 support? What about [insert language here]?</question>
+ <question>What plugin languages does Maven support? What about [insert language here]?</question>
<answer>
<p>
As of the current release, Maven supports pure Java and Beanshell. Java is the preferred
language for it's familiarity and speed.
</p>
<p>
- We get asked a lot whether Maven 2.0 will support other languages, in particular Groovy.
+ We get asked a lot whether Maven will support other languages, in particular Groovy.
We will allow the use of Groovy - and virtually any other scripting
language (if there is demand) if someone can commit a small amount of time to implementing a
factory for it.
</p>
<p>
- We would recommend waiting for Groovy to have a 1.0 release so the API
- (and language!) is stable. What we will not be doing is actively
- supporting it (in terms of answering questions about how to use it)
- like we currently do for Jelly in Maven 1.x.
- </p>
- <p>
Beanshell is more mature, and we want a language that users will find
answers for when they look, and that when they find bugs, it is
clearly defined where they actually are.
@@ -117,10 +89,10 @@
</faq>
<faq id="get-help">
- <question>Where do I get help with Maven 2 & 3?</question>
+ <question>Where do I get help with Maven?</question>
<answer>
<p>
- Help for both Maven 1.0 and Maven 2 & 3 can be obtained by subscribing and posting to the
+ Help for Maven can be obtained by subscribing and posting to the
<a href="https://maven.apache.org/mailing-lists.html">Maven Users List</a>.
</p>
<p>
diff --git a/content/fml/maven1.fml b/content/fml/maven1.fml
deleted file mode 100644
index 1b86d6b..0000000
--- a/content/fml/maven1.fml
+++ /dev/null
@@ -1,171 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
- 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.
--->
-
-<faqs xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns="http://maven.apache.org/FML/1.0"
- xsi:schemaLocation="http://maven.apache.org/FML/1.0 https://maven.apache.org/xsd/fml-1.0.xsd"
- title="Information for Maven 1.0 Users">
- <part id="maven1">
- <faq id="changed">
- <question>What's Changed?</question>
- <answer>
- <p>
- 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>
- <li>
- <i>Faster and smaller</i>
- - The Maven core no longer uses Ant, Jelly or Xerces making it much smaller, has
- fewer dependencies, and is perfect for embedding in other tools.
- </li>
- <li>
- <i>Defined build lifecycle</i>
- - 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>
- work for any project type.
- </li>
- <li>
- <i>Built-in multiple project handling</i>
- - Use the same goals on a set of projects, and aggregate the
- results.
- </li>
- <li>
- <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>).
- </li>
- <li>
- <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
- was used for, such as goal aliasing).
- </li>
- <li>
- <i>No more Jelly</i>
- - Plugins are primarily written in Java, though there are providers for other scripting languages.
- </li>
- <li>
- <i>Improved repository layout</i>
- - 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.x, Maven 3.x, or Maven 1.0?</question>
- <answer>
- <p>
- 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 3.x, as it is very much improved.
- However, we still continue to support the Maven 1.x releases at this time.
- </p>
- <p>
- If you do use Maven 1.0, and would like to upgrade in the future, you should carefully consider following some
- of the
- <a href="https://maven.apache.org/maven-1.x/using/bestpractices.html">Best Practices</a>
- 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.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>Maven 1 repository layout is not supported</li>
- </ul>
- </answer>
- </faq>
- <faq id="m1-future">
- <question>What will happen to Maven 1.0?</question>
- <answer>
- <p>
- Support for Maven 1.0.2 has been discontinued with the release of Maven 1.1.
- While significant new features will not be added to the
- <a href="https://maven.apache.org/maven-1.x/">Maven 1.x</a> core
- (such as transitive dependencies), bugfixes and support continue and the
- repository is still available.
- </p>
- </answer>
- </faq>
- <faq id="m1-plugins">
- <question>Will my Maven 1.0 plugins be supported?</question>
- <answer>
- <p>
- Not directly.
- </p>
- <p>
- We recommend building your Jelly plugins as thin wrappers around Java beans that do not use Maven 1.0 API's,
- which will allow easy migration to Maven 2.0.
- </p>
- </answer>
- </faq>
- <faq id="m1-maven-xml">
- <question>How do I write custom scripts without a
- <code>maven.xml</code>
- file?
- </question>
- <answer>
- <p>Taken from
- <a href="https://mail-archives.apache.org/mod_mbox/maven-users/200504.mbox/%3c1113788711.5625.30.camel@172.16.1.36%3e">
- this post to the Maven User's List</a>:
- </p>
- <blockquote>
- Everything in m2 is a plugin so for doing any sort of custom work like
- that you will need to make a plugin. This 1) greatly reduces the
- complexity within m2 because we only deal with proper plugins. The
- maven.xml file in m1 was a pseudo plugin essentially and greatly
- complicated the internals and 2) it promotes the sharing of your work
- right from the get go. To start with you'll probably write a plugin that
- is only applicable to your specific requirements, or your team's work,
- but you'll see people asking for some functionality and you'll go "hey,
- I have something like that!" and hopefully people who have concrete
- solutions will generalize their solutions so they can be shared with
- others. That's what we're trying to encourage.
- </blockquote>
- <blockquote>
- We estimate that there's a lot of work bound up in project's maven.xml
- that is not being shared and we'd like to try and change that. We plan
- to make it dead simple to share plugins and hopefully people can use
- other project's plugins as a start for a plugin that they may need
- themselves.
- </blockquote>
- </answer>
- </faq>
- <faq id="convert">
- <question>How do I convert from Maven 1.x to Maven 2.x or 3.x?</question>
- <answer>
- This is discussed in <a href="https://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>
diff --git a/content/markdown/faq-unoffical.md b/content/markdown/faq-unoffical.md
index 48af0f7..9ec1194 100644
--- a/content/markdown/faq-unoffical.md
+++ b/content/markdown/faq-unoffical.md
@@ -35,15 +35,13 @@ This page serves as a collection of questions *with* answers. If you have a freq
[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?]
### Eclipse
[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?]
+[Where can I get the Maven plugin for Eclipse?](#Where can I get the Maven 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 is not the same as the artifactId?](#Does it matter if the project's directory name is not the same as the artifactId?]
@@ -56,7 +54,6 @@ This page serves as a collection of questions *with* answers. If you have a freq
[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, What 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?]
@@ -81,8 +78,6 @@ This page serves as a collection of questions *with* answers. If you have a freq
### Dependencies
-[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?]
@@ -100,13 +95,13 @@ This page serves as a collection of questions *with* answers. If you have a freq
[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 specify my remote repo in Maven?](#How do I specify my remote repo in Maven?]
[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.]
+[#List of available maven 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)?]
+[What is the purpose of remote repository (other than ibiblio)?](#What is the purpose of remote repository (other than ibiblio)?]
### Errors
@@ -116,12 +111,6 @@ This page serves as a collection of questions *with* answers. If you have a freq
[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 "Deployment 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?]
-
-### Supported Features
-
-[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?]
### Maven Comparisons
@@ -129,7 +118,7 @@ This page serves as a collection of questions *with* answers. If you have a freq
### Ant
-[How can I use Ant tasks in Maven 2?](#How can I use Ant tasks in Maven 2?]
+[How can I use Ant tasks in Maven?](#How can I use Ant tasks in Maven?]
[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?]
@@ -148,7 +137,6 @@ This page serves as a collection of questions *with* answers. If you have a freq
### Deploy
[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?]
@@ -200,13 +188,12 @@ This page serves as a collection of questions *with* answers. If you have a freq
[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?]
+[Where is the source code? I couldn't seem to find a link anywhere on the Maven site.](#Where is the source code? I couldn't seem to find a link anywhere on the Maven site.]
[How do I add my generated sources to the compile path of Maven, 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?]
+[How to run a java program from Maven?](#How to run a java program from Maven?]
[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 sun.jdk-tools-jar-1.4.0 on MacOSX?](#Where to get sun.jdk-tools-jar-1.4.0 on MacOSX?]
@@ -217,7 +204,7 @@ This page serves as a collection of questions *with* answers. If you have a freq
[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 configurable 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?]
+[How should I point a path for Maven 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 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 an 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?]
@@ -307,60 +294,11 @@ To resolve this error:
If the error persists, browse [archived discussions](http://www.mail-archive.com/users@maven.apache.org/), post to the Maven user list, or log a [ticket](http://jira.codehaus.org/browse/MNG) describing your problem, if you think it is a bug. Tickets may also be issued for feature enhancement requests, and other tasks.
-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 [MNG-2408](http://jira.codehaus.org/browse/MNG-2408).
-
-_Dependencies_
-
-### How do I implement "maven.jar.override" of Maven 1 with Maven 2?
-
-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":
-
-```
-<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>
-```
-* 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.
-
-```
-<dependencies>
- <dependency>
- <groupId>acme</groupId>
- <artifactId>worker</artifactId>
- <version>1.2</version>
- </dependency>
-</dependencies>
-```
-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.
-
_Errors, Dependencies, Plugins_
### How do I install a file in my local repository along with a generic POM?
-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).
+You may do this by typing this command (please take note that this is a single line only).
```
mvn install:install-file
@@ -379,7 +317,7 @@ This command installs the jar in your local repository with the generated generi
### How do I install a file in my local repository along with my customized POM?
-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.
+The solution requires the `-DpomFile=<path-to-pom>` parameter just like the sample below.
```
mvn install:install-file
-DgroupId=<group-id>
@@ -399,14 +337,6 @@ correctly point out only work when the site is deployed.
_Plugins & Lifecycle_
-### Does Maven 2.x support pre/postGoals?
-
-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?
-
-Pre- and post-goals in Maven 1.x were usually used to develop the concept of a workflow, or lifecycle, for the build, where *x* happened before *y*, 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 w [...]
-
-For more information, see [Introduction to the Build Lifecycle](http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html)
-
_General_
### What is the difference between Maven and Ivy?
@@ -571,9 +501,9 @@ _Repositories, General_
To get a list of archetypes, refer to the following page [http://svn.apache.org/viewcvs.cgi/maven/archetype/trunk/maven-archetypes)
-### 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)?
+### How do I specify my remote repo in Maven?
-To specify a remote repo in Maven 2.0, add the `<repositories>` element to the POM:
+To specify a remote repo in Maven, add the `<repositories>` element to the POM:
```
<repositories>
@@ -608,12 +538,6 @@ _Repositories_
```
_Plugins and Lifecycle, IDEs_
-### How do I invoke the "maven dist" function from Maven 1.0, in Maven 2.0?
-
-mvn assembly:assembly
-
-See the [Assembly Plugin documentation](http://maven.apache.org/plugins/maven-assembly-plugin/) for more details.
-
_General, Plugins and Lifecycle_
### Can a profile inherit the configuration of a "sibling" profile?
@@ -735,10 +659,6 @@ run `mvn -X`
_POM, Dependencies_
-### Is there a property file for plug-in configuration in Maven 2.0?
-
-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.
-
_General, POM, Plugins and Lifecycle, Command Line_
### How do I determine the stale resources in a Mojo to avoid reprocessing them?
@@ -895,27 +815,6 @@ You could create a specific profile that skips the reporting and test phases.
Also refer to [How do I skip unit tests when building a project?](How do I skip unit tests when building a project?)
-
-### How do I configure the equivalent of maven.war.src of war plugin in Maven 2.0?
-
-```
-<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>
-```
-See [http://maven.apache.org/plugins/maven-war-plugin/war-mojo.html] for other configurable properties of the war plugin.
-
-
### How do I execute the assembly plugin with different configurations?
Add this to your pom,
@@ -1079,13 +978,13 @@ Currently, this type of summary information is not built into the compiler plugi
_Sites & Reporting_
-### 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)?
+### 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)?
-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](http://docs.codehaus.org/display/MAVEN/Maven+2.1+Design+Documents].
+Currently, this is not possible. The main reason is that it's 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.
_Design, Patterns & Best Practices_
-### Where can I get the Maven 2 plugin for Eclipse?
+### Where can I get the Maven plugin for Eclipse?
[http://maven.apache.org/eclipse-plugin.html]
@@ -1316,7 +1215,7 @@ _Plugins and Lifecycle, IDEs_
When a Mojo has a `@aggregator` expression, it means that It can only build the parent project of your multi-module-project, the one who has the packaging of pom. It can also give you values for the expression $\{reactorProjects\} where reactorProjects are the MavenProject references to the parent pom modules.
-### Why there are no dependency properties in Maven 2?
+### Why there are no dependency properties in Maven?
They were removed because they aren't reliable in a transitive environment. It implies that the dependency knows something about the
environment of the dependee, which is back to front. In most cases, granted, the value for war bundle will be the same for a particular
@@ -1333,7 +1232,7 @@ Dependencies with this scope will not be passed on transitively, nor will they b
### How do I list available plugins?
-The "Available Plugins" page lists them, and provides additional information to browse the Maven 2 repository. See [http://maven.apache.org/plugins]
+The "Available Plugins" page lists them, and provides additional information to browse the Maven repository. See [http://maven.apache.org/plugins]
### How do I determine what version of a plugin I am using?
@@ -1341,7 +1240,7 @@ You can use the Maven Help Plugin's describe goal. For example, to find out the
{noformat}mvn -Dplugin=install help:describe
{noformat}Note that you must give the plugin prefix as the argument to plugin, not it's artifact ID.
-### How can I use Ant tasks in Maven 2?
+### How can I use Ant tasks in Maven?
There are currently 2 alternatives:
* For use in a plugin written in Java, Beanshell or other Java-like scripting language, you can construct the Ant tasks [using the instructions given in the Ant documentation](http://ant.apache.org/manual/antexternal.html)
@@ -1355,13 +1254,13 @@ By configuring `<sourceDirectory>`, `<resources>` and other elements of the `<bu
In addition, you may need to change the plugin configuration if you are not using plugin defaults for their files/directories.
-### 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 Maven site.
The source code can be found in subversion: [http://svn.apache.org/repos/asf/maven/components/trunk].
-For more information, see [Building Maven 2.0](http://maven.apache.org/guides/development/guide-building-m2.html)
+For more information, see [Building Maven](http://maven.apache.org/guides/development/guide-building-m2.html)
-### Why does Maven compile my test classes but don't run them?
+### Why does Maven compile my test classes but doesn't run them?
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:
@@ -1414,7 +1313,7 @@ We have compiled a list of available resources on the [getting help page](http:/
The source for the model package is generated by modello. From your maven-model source, build it and you should able to see tha java files inside /target/generated-sources directory.
-### List of available maven 2 mirrors.
+### List of available Maven mirrors.
Here is the list of available mirrors you can use, just use one of the following mirror entries in your settings.xml
@@ -1456,10 +1355,6 @@ Here is the list of available mirrors you can use, just use one of the following
</settings>
```
-### How does maven 2 implement reproducibility?
-
-- Add the exact versions of plugins into your pluginDepenencies (make use of the release plugin)
-- Make use of ibiblio for your libraries. This should always be the case for jars. (The group is working on stabilising metadata and techniques for locking it down even if it changes. An internal repository mirror that doesn't fetch updates (only new) is recommended for true reproducibility.)
### Unsupported Protocol Error when deploying a 3rd party jar. What should I do?
@@ -1588,7 +1483,7 @@ For example, From 1.0-SNAPSHOT to 1.0
2. Use the maven-release-plugin to prepare and create the official RELEASE version of your project artifact.
Please see [http://maven.apache.org/guides/mini/guide-releasing.html] for more reference.
-### How to run a java program from M2?
+### How to run a java program from Maven?
You may use the exec-maven-plugin for this. [http://mojo.codehaus.org/exec-maven-plugin/usage.html]
@@ -1706,9 +1601,9 @@ Note: You don't have to define the central repo (i.e. ibiblio).
You can configure maven-compiler-plugin to exclude your unwanted packages or files to be compiled in the first place. But you will not be able to prevent javac to compile those files if they are referenced by other packages within the source tree. To prevent that, you will need to use antrun plugin ( or write your own custom plugin), bind it to compile phase, and remove unwanted classes in $\{project.build.directory\}/classes. If possible, just move those pacakges/files to another source [...]
-### 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 to use a certain version of JDK when I have different versions of JDK installed on my PC and my JAVA_HOME already set?
-If yu don't want to change your system JAVA_HOME, set it in maven script instead.
+If you don't want to change your system JAVA_HOME, set it in maven script instead.
### 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?
@@ -1881,16 +1776,6 @@ pom.xml > project scope
$\{reactorProjects} are the projects that the current mvn command are going to be built. This will include the parent project and all its children while $\{executedProject} is the project where you typed your mvn command.
-### Why do i get an 'error downloading artifact' message when building with Maven 2 under Fedora Core 4 and Java 1.4?
-
-Some versions of Java 1.4 are incompatible with the IPv6 networking protocol, leading to socket errors when Java attempts to establish network connections. IPv6 is enabled by default in Fedora Core 4, and in recent kernel updates (2.6.12) to Fedora Core 3. This causes maven to fail to download jars from remote repositories. The symptoms are:
-{color:#ff0000}java.net.SocketException: Invalid argument or cannot assign requested address{color}
-
-To solve this, add *_\-Djava.net.preferIPv4Stack=true{_}* to your maven invocation, i.e.
-{color:#ff0000}mvn install \-Djava.net.preferIPv4Stack=true{color}
-
-More information can be found at [http://wiki.astrogrid.org/bin/view/Deploy/IPV6Warning?skin=print]
-
### What is a Snapshot?
A snapshot is a development version. e.g, 2.0-SNAPSHOT is the still-in-development future 2.0.
diff --git a/content/xdoc/docs-required.xml b/content/xdoc/docs-required.xml
deleted file mode 100644
index 9208dc6..0000000
--- a/content/xdoc/docs-required.xml
+++ /dev/null
@@ -1,192 +0,0 @@
-<?xml version="1.0"?>
-
-<!--
- 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.
--->
-
-<document xmlns="http://maven.apache.org/XDOC/2.0"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 https://maven.apache.org/xsd/xdoc-2.0.xsd">
-<!-- TODO: include back into site, after checking which are complete, add to instructions on how to contribute docs -->
- <properties>
- <title>Documentation Required</title>
- <author email="brett@apache.org">Brett Porter</author>
- </properties>
- <body>
- <section name="Documentation Required">
- <p>
- This page lists some of the most pressing documentation needs. If you feel something is missing, please be sure
- to let us know at the
- <a href="./mailing-lists.html">Maven Users Mailing List</a>.
- </p>
- <h4>Documentation for users</h4>
- <ul>
- <li>new SNAPSHOT handling -
- <i>partially done on Brett's blog</i>
- </li>
- <li>guide to dependencies, including:
- <ul>
- <li>dependency scoping - <i>especially system scope</i></li>
- <li>version range specifications</li>
- <li>conflict resolution</li>
- </ul>
- </li>
- <li>deployment mechanism</li>
- <li>dependency management</li>
- <li>plugin management -
- <i>in progress by J Matthew Pryor and John Casey</i>
- </li>
- <li>plugin configuration</li>
- <li>plugin downloading -
- <i>partial on Brett's blogs</i>
- </li>
- <li>report generation</li>
- <li>project inheritence and company wide strategy</li>
- <li>plugin documentation</li>
- <li>using POM-properties in conjunction with plugin configuration to abstract child-POM configs</li>
- <li>archetypes - writing and using</li>
- <li>plugin usage guide/summary for core plugins - <i>esp. release plugin</i></li>
- <li>strategy for migrating from Ant builds</li>
- <li>strategy for migrating from Maven 1.x builds - <i>esp. plugins that don't convert directly</i></li>
- </ul>
- <h4>Documentation for plugin authors</h4>
- <ul>
- <li>Beanshell examples</li>
- <li>plugin writing guide</li>
- <li>report writing guide</li>
- <li>site customisation guide</li>
- <li>common tips and tricks for accessing project/build data</li>
- <li>guide to available parameter expressions</li>
- <li>list of standards for submitting new plugins (minimum documentation, test coverage?)</li>
- </ul>
- <h4>Documentation for Maven developers</h4>
- <ul>
- <li>Lifecycle architecture</li>
- <li>High level architecture, components explanation</li>
- <li>Intro to Plexus</li>
- <li>contributors guide (add to current and consolidate, walk through some first steps)</li>
- </ul>
- <h4>Additional Notes</h4>
- <pre>
- Brett Porter wrote:
- > The active project changes during the reactor build. At the compile
- > stage, it refers to the target/classes directory. At the package
- > stage, it points to the jar file. If you are implementing your own
- > packaging goal, you need to call project.getArtifact().setFile( ... )
- > to ensure this is used.
-
- - multi module howto
- - per user scm setup
- - outline behaviour when connection and developConnection are defined
-
- Our current URL looks like:
- scm:cvs:pserver:@cvs.host.name:/cvsroot:module-version
-
- Using this URL, the default is to connect to the CVS server using the
- same userid as the current user. This is the desired behavior and I
- don't want to mess that up. I just would like a means to add a userid
- in the URL only in special circumstances like Continuum.
-
- We might want to do something where we say it is a best practice to
- specify a ${user} and take it from the environment and allow an override.
-
- - testing a plugin
- - How to get started behind an NTLM proxy.
- - How snapshots works
- - How do i use the lifecycle provided by a plugin:
- - How do i disable ibiblio
- - using version ranges
- - plugin expressions (look at bob allison's work)
- - overriding the central repository (use central)
- - description of what packagings are available and how they work
- - creating upload bundles
- - modello example
- - changing the snapshot policy frequency
- - overriding central repo
- - using POM info in applications: the POM is packaged so there is acccess
- continuum example to get the version.
- - quick description of scm,wagon,continuum
- </pre>
- <h4>Profiles Example</h4>
- <pre><![CDATA[
-it's possible to do it with m2 beta-1 and profiles.
-
-you declare profile in your pom like this:
-
- <profiles>
- <profile>
- <id>env-test</id>
- <activation>
- <property>
- <name>env</name>
- <value>test</value>
- </property>
- </activation>
- <properties>
- <appProperties>test.properties</appProperties>
- </properties>
- </profile>
- <profile>
- <id>env-production</id>
- <activation>
- <property>
- <name>env</name>
- <value>production</value>
- </property>
- </activation>
- <properties>
- <appProperties>app.properties</appProperties>
- </properties>
- </profile>
- </profiles>
-
-and you can run mvn with one of profiles like:
-mvn -P env-production clean:clean install ==> we use the profile id
-or
-mvn -Denv=test clean:clean install ==> we use the property env define in
-<activation>
-
-Emmanuel
-
-martin.kuhn@merkur.at wrote:
-> Hi,
->
-> I'm a maven newbie and I try out maven 2.0 alpha 3.
->
-> My questions:
->
-> I have a project to build / deploy for three different enviroments (test,
-> integration, production).
->
-> The difference beetween the bundles is only a properties file (there are
-> three different files: config-test.properties,
-> config-integration.properties ...).
-> In the build process I want to copy the right config file to a file with a
-> common name (config.properties -> the app should work with this config
-> file)
->
-> Is there a solution to handle this with maven 2 or do I have to write a
-> plugin?
->
- ]]>
- </pre>
- </section>
- </body>
-</document>
-
-