You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by br...@apache.org on 2008/02/11 07:01:39 UTC
svn commit: r620422 [2/3] - in /maven/components/branches/maven-2.0.x-terse:
./ maven-core/src/main/java/org/apache/maven/lifecycle/ maven-model/
maven-model/src/main/mdo/ maven-plugin-descriptor/
maven-plugin-parameter-documenter/ maven-plugin-registr...
Modified: maven/components/branches/maven-2.0.x-terse/maven-model/src/main/mdo/maven.mdo
URL: http://svn.apache.org/viewvc/maven/components/branches/maven-2.0.x-terse/maven-model/src/main/mdo/maven.mdo?rev=620422&r1=620421&r2=620422&view=diff
==============================================================================
--- maven/components/branches/maven-2.0.x-terse/maven-model/src/main/mdo/maven.mdo (original)
+++ maven/components/branches/maven-2.0.x-terse/maven-model/src/main/mdo/maven.mdo Sun Feb 10 22:01:36 2008
@@ -42,6 +42,7 @@
| definition of these types
|
-->
+<!-- TODO [BP]: for all lists, consider listStyle="flat" (but check it works if they aren't consecutive -->
<model>
<id>maven</id>
<name>Maven</name>
@@ -61,8 +62,14 @@
<value>org.apache.maven.model</value>
</default>
</defaults>
+ <versionDefinition>
+ <!-- TODO [BP]: would prefer to read it from the namespace, but modello won't fallback to 4.0.0 if not there -->
+ <type>field</type>
+ <value>modelVersion</value>
+ </versionDefinition>
<classes>
- <class rootElement="true" xml.tagName="project">
+ <class rootElement="true" xml.tagName="project" xml.namespace="http://maven.apache.org/POM/${version}"
+ xml.schemaLocation="http://maven.apache.org/xsd/maven-${version}.xsd">
<name>Model</name>
<superClass>ModelBase</superClass>
<description>
@@ -89,7 +96,7 @@
</field>
<field>
<name>parent</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The location of the parent project, if one exists. Values from the
@@ -101,11 +108,10 @@
<association>
<type>Parent</type>
</association>
- <comment></comment>
</field>
<field>
<name>modelVersion</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<required>true</required>
<description>
<![CDATA[
@@ -114,6 +120,17 @@
</description>
<type>String</type>
</field>
+ <!-- TODO: it would be better if this was in the project - so that conversion of model was part of the pipeline instead of the initial loading -->
+ <field>
+ <name>originalModelVersion</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ Declares to which version of project descriptor this POM was loaded from.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
<field>
<name>pomVersion</name>
<version>3.0.0</version>
@@ -126,6 +143,7 @@
]]>
</description>
</field>
+ <!-- TODO [BP]: consider replacing with <id groupId="..." etc />, and similar for other project level elements -->
<field>
<name>groupId</name>
<version>3.0.0+</version>
@@ -168,7 +186,7 @@
</field>
<field>
<name>packaging</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The type of artifact this project produces, for example <code>jar</code>
@@ -207,7 +225,7 @@
</field>
<field>
<name>version</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<required>true</required>
<description>
<![CDATA[
@@ -268,7 +286,7 @@
</field>
<field>
<name>prerequisites</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Describes the prerequisites in the build environment for
this project.
@@ -289,7 +307,7 @@
</field>
<field>
<name>issueManagement</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The project's issue management system information.
@@ -301,7 +319,7 @@
</field>
<field>
<name>ciManagement</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The project's continuous integration information.
@@ -494,7 +512,7 @@
</field>
<field>
<name>scm</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Specification for the SCM used by the project, such as CVS, Subversion, etc.
@@ -572,7 +590,7 @@
</field>
<field>
<name>profiles</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
A listing of project-local build profiles which will modify
@@ -614,7 +632,7 @@
</code>
</codeSegment>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
/**
@@ -650,7 +668,7 @@
<fields>
<field>
<name>modules</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
The modules (sometimes called subprojects) to build as a
part of this project. Each module listed is a relative path
@@ -663,7 +681,7 @@
</field>
<field>
<name>repositories</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The lists of the remote repositories for discovering dependencies and
@@ -677,7 +695,7 @@
</field>
<field>
<name>pluginRepositories</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The lists of the remote repositories for discovering plugins for builds and reports.
@@ -719,7 +737,7 @@
</field>
<field>
<name>reporting</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
This element includes the specification of report plugins to use
@@ -734,7 +752,7 @@
</field>
<field>
<name>dependencyManagement</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<required>false</required>
<description>
<![CDATA[
@@ -751,7 +769,7 @@
</field>
<field>
<name>distributionManagement</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Distribution information for a project that enables deployment of the site
@@ -764,7 +782,7 @@
</field>
<field>
<name>properties</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Properties that can be used throughout the POM as a substitution, and
@@ -815,7 +833,7 @@
<fields>
<field>
<name>plugins</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>The list of plugins to use.</description>
<association>
<type>Plugin</type>
@@ -825,7 +843,7 @@
</fields>
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
java.util.Map pluginMap;
@@ -878,7 +896,7 @@
| plugins to be used in sub-projects. -->
<field>
<name>pluginManagement</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<required>false</required>
<description>
<![CDATA[
@@ -907,7 +925,18 @@
<fields>
<field>
<name>defaultGoal</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
+ <description>
+ <![CDATA[
+ The default goal (or phase in Maven 2) to execute when none is
+ specified for the project.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>defaultGoal</name>
+ <version>4.1.0+</version>
<description>
<![CDATA[
The default goal (or phase in Maven 2) to execute when none is
@@ -933,7 +962,7 @@
</field>
<field>
<name>testResources</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
This element describes all of the classpath resources such as
@@ -967,9 +996,31 @@
</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>directory</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The directory where all files generated by the build are placed.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>finalName</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The filename (excluding the extension, and with no path information) that
+ the produced artifact will be called.
+ The default value is <code>${artifactId}-${version}</code>.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
<field>
<name>filters</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The list of filter properties files that are used when filtering is enabled.
@@ -1007,7 +1058,21 @@
</field>
<field>
<name>sourceDirectory</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
+ <required>true</required>
+ <description>
+ <![CDATA[
+ This element specifies a directory containing the source
+ of the project. The generated build system will compile
+ the source in this directory when the project is built.
+ The path given is relative to the project descriptor.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>sourceDirectory</name>
+ <version>4.1.0+</version>
<required>true</required>
<description>
<![CDATA[
@@ -1034,6 +1099,21 @@
</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>scriptSourceDirectory</name>
+ <version>4.1.0+</version>
+ <required>true</required>
+ <description>
+ <![CDATA[
+ This element specifies a directory containing the script sources
+ of the project. This directory is meant to be different from the
+ sourceDirectory, in that its contents will be copied to the output
+ directory in most cases (since scripts are interpreted rather than
+ compiled).
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
<field>
<name>unitTestSourceDirectory</name>
<version>3.0.0</version>
@@ -1062,6 +1142,20 @@
</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>testSourceDirectory</name>
+ <version>4.1.0+</version>
+ <required>true</required>
+ <description>
+ <![CDATA[
+ This element specifies a directory containing the unit test
+ source of the project. The generated build system will
+ compile these directories when the project is being tested.
+ The path given is relative to the project descriptor.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
<field>
<name>aspectSourceDirectory</name>
<version>3.0.0</version>
@@ -1138,9 +1232,29 @@
</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>outputDirectory</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The directory where compiled application classes are placed.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>testOutputDirectory</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The directory where compiled test classes are placed.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
<field>
<name>extensions</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
A set of build extensions to use from this project.
</description>
@@ -1153,7 +1267,7 @@
</class>
<class>
<name>CiManagement</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The <code><CiManagement></code> element contains informations required to the
@@ -1181,9 +1295,29 @@
</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>system</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The name of the continuous integration system, e.g. <code>continuum</code>.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>url</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ URL for the continuous integration system used by the project if it has a web interface.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
<field>
<name>notifiers</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Configuration for notifying developers/users when a build is
@@ -1203,7 +1337,7 @@
Configures one method for notifying users/developers when a
build breaks.
</description>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<fields>
<field>
<name>type</name>
@@ -1250,7 +1384,51 @@
Whether to send notifications on warning.
</description>
</field>
- <!-- TODO: Remove it after continuum alpha-3 release -->
+ <field xml.attribute="true">
+ <name>type</name>
+ <version>4.1.0+</version>
+ <defaultValue>mail</defaultValue>
+ <type>String</type>
+ <description>
+ The mechanism used to deliver notifications.
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>sendOnError</name>
+ <version>4.1.0+</version>
+ <defaultValue>true</defaultValue>
+ <type>boolean</type>
+ <description>
+ Whether to send notifications on error.
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>sendOnFailure</name>
+ <version>4.1.0+</version>
+ <defaultValue>true</defaultValue>
+ <type>boolean</type>
+ <description>
+ Whether to send notifications on failure.
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>sendOnSuccess</name>
+ <version>4.1.0+</version>
+ <defaultValue>true</defaultValue>
+ <type>boolean</type>
+ <description>
+ Whether to send notifications on success.
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>sendOnWarning</name>
+ <version>4.1.0+</version>
+ <defaultValue>true</defaultValue>
+ <type>boolean</type>
+ <description>
+ Whether to send notifications on warning.
+ </description>
+ </field>
<field>
<name>address</name>
<version>4.0.0</version>
@@ -1263,6 +1441,7 @@
</field>
<field>
<name>configuration</name>
+ <version>4.0.0+</version>
<description>
Extended configuration specific to this notifier goes here.
</description>
@@ -1285,7 +1464,7 @@
<fields>
<field>
<name>name</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The full name of the contributor.
@@ -1295,7 +1474,7 @@
</field>
<field>
<name>email</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The email address of the contributor.
@@ -1305,7 +1484,7 @@
</field>
<field>
<name>url</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The URL for the homepage of the contributor.
@@ -1317,7 +1496,7 @@
<field>
<name>organization</name>
<alias>organisation</alias>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The organization to which the contributor belongs.
@@ -1328,7 +1507,7 @@
<field>
<name>organizationUrl</name>
<alias>organisationUrl</alias>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The URL of the organization.
@@ -1338,7 +1517,7 @@
</field>
<field>
<name>roles</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The roles the contributor plays in the project. Each role is
@@ -1353,7 +1532,7 @@
</field>
<field>
<name>timezone</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The timezone the contributor is in. This is a number in the range -11 to 12.
@@ -1361,82 +1540,195 @@
</description>
<type>String</type>
</field>
- <field>
- <name>properties</name>
- <version>3.0.0+</version>
+ <field xml.attribute="true">
+ <name>name</name>
+ <version>4.1.0+</version>
<description>
<![CDATA[
- Properties about the contributor, such as an instant messenger handle.
+ The full name of the contributor.
]]>
</description>
- <type>Properties</type>
- <association xml.mapStyle="inline">
- <type>String</type>
- <multiplicity>*</multiplicity>
- </association>
+ <type>String</type>
</field>
- </fields>
- </class>
- <class>
- <name>Dependency</name>
- <version>3.0.0+</version>
- <description>
- <![CDATA[
- The <code><dependency></code> element contains information about a dependency
- of the project.
- ]]>
- </description>
- <fields>
- <field>
- <name>id</name>
- <version>3.0.0</version>
- <required>true</required>
+ <field xml.attribute="true">
+ <name>email</name>
+ <version>4.1.0+</version>
<description>
<![CDATA[
- <strong>Deprecated</strong>. Please use <code>groupId</code> and
- <code>artifactId</code> together instead.
+ The email address of the contributor.
]]>
</description>
<type>String</type>
</field>
- <field>
- <name>groupId</name>
- <version>3.0.0+</version>
- <required>true</required>
+ <field xml.attribute="true">
+ <name>url</name>
+ <version>4.1.0+</version>
<description>
<![CDATA[
- The project group that produced the dependency, e.g.
- <code>org.apache.maven</code>.
+ The URL for the homepage of the contributor.
]]>
</description>
<type>String</type>
</field>
- <field>
- <name>artifactId</name>
- <version>3.0.0+</version>
- <required>true</required>
+ <!-- TODO [BP]: should this just be a single Organization element, we can map in the converter -->
+ <field xml.attribute="true">
+ <name>organization</name>
+ <alias>organisation</alias>
+ <version>4.1.0+</version>
<description>
<![CDATA[
- The unique id for an artifact produced by the project group, e.g.
- <code>maven-artifact</code>.
+ The organization to which the contributor belongs.
]]>
</description>
<type>String</type>
</field>
- <field>
- <name>version</name>
- <version>3.0.0+</version>
+ <field xml.attribute="true">
+ <name>organizationUrl</name>
+ <alias>organisationUrl</alias>
+ <version>4.1.0+</version>
<description>
<![CDATA[
- The version of the dependency, e.g. <code>3.2.1</code>. In Maven 2, this can also be
- specified as a range of versions.
+ The URL of the organization.
]]>
</description>
<type>String</type>
</field>
<field>
- <name>url</name>
- <version>3.0.0</version>
+ <name>roles</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The roles the contributor plays in the project. Each role is
+ described by a <code>role</code> element, the body of which is a
+ role name. This can also be used to describe the contribution.
+ ]]>
+ </description>
+ <association>
+ <type>String</type>
+ <multiplicity>*</multiplicity>
+ </association>
+ </field>
+ <field xml.attribute="true">
+ <name>timezone</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The timezone the contributor is in. This is a number in the range -11 to 12.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field>
+ <name>properties</name>
+ <version>3.0.0+</version>
+ <description>
+ <![CDATA[
+ Properties about the contributor, such as an instant messenger handle.
+ ]]>
+ </description>
+ <type>Properties</type>
+ <association xml.mapStyle="inline">
+ <type>String</type>
+ <multiplicity>*</multiplicity>
+ </association>
+ </field>
+ </fields>
+ </class>
+ <class>
+ <name>Dependency</name>
+ <version>3.0.0+</version>
+ <description>
+ <![CDATA[
+ The <code><dependency></code> element contains information about a dependency
+ of the project.
+ ]]>
+ </description>
+ <fields>
+ <field>
+ <name>id</name>
+ <version>3.0.0</version>
+ <required>true</required>
+ <description>
+ <![CDATA[
+ <strong>Deprecated</strong>. Please use <code>groupId</code> and
+ <code>artifactId</code> together instead.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field>
+ <name>groupId</name>
+ <version>3.0.0/4.0.0</version>
+ <required>true</required>
+ <description>
+ <![CDATA[
+ The project group that produced the dependency, e.g.
+ <code>org.apache.maven</code>.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>groupId</name>
+ <version>4.1.0+</version>
+ <required>true</required>
+ <description>
+ <![CDATA[
+ The project group that produced the dependency, e.g.
+ <code>org.apache.maven</code>.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field>
+ <name>artifactId</name>
+ <version>3.0.0/4.0.0</version>
+ <required>true</required>
+ <description>
+ <![CDATA[
+ The unique id for an artifact produced by the project group, e.g.
+ <code>maven-artifact</code>.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>artifactId</name>
+ <version>4.1.0+</version>
+ <required>true</required>
+ <description>
+ <![CDATA[
+ The unique id for an artifact produced by the project group, e.g.
+ <code>maven-artifact</code>.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field>
+ <name>version</name>
+ <version>3.0.0/4.0.0</version>
+ <description>
+ <![CDATA[
+ The version of the dependency, e.g. <code>3.2.1</code>. In Maven 2, this can also be
+ specified as a range of versions.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>version</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The version of the dependency, e.g. <code>3.2.1</code>. In Maven 2, this can also be
+ specified as a range of versions.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field>
+ <name>url</name>
+ <version>3.0.0</version>
<description>
<![CDATA[
This url will be provided to the user if the jar file cannot be downloaded
@@ -1505,6 +1797,39 @@
<type>String</type>
<required>false</required>
</field>
+ <field xml.attribute="true">
+ <name>type</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The type of dependency. This defaults to <code>jar</code>. While it
+ usually represents the extension on the filename of the dependency,
+ that is not always the case. A type can be mapped to a different
+ extension and a classifier.
+ The type often correspongs to the packaging used, though this is also
+ not always the case.
+ Some examples are <code>jar</code>, <code>war</code>, <code>ejb-client</code>
+ and <code>test-jar</code>.
+ New types can be defined by plugins that set
+ <code>extensions</code> to <code>true</code>, so this is not a complete list.
+ ]]>
+ </description>
+ <type>String</type>
+ <defaultValue>jar</defaultValue>
+ </field>
+ <field xml.attribute="true">
+ <name>classifier</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The classifier of the dependency. This allows distinguishing two artifacts
+ that belong to the same POM but were built differently, and is appended to
+ the filename after the version. For example, <code>jdk14</code> and <code>jdk15</code>.
+ ]]>
+ </description>
+ <type>String</type>
+ <required>false</required>
+ </field>
<field>
<name>properties</name>
<version>3.0.0</version>
@@ -1558,9 +1883,45 @@
</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>scope</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The scope of the dependency - <code>compile</code>, <code>runtime</code>,
+ <code>test</code>, <code>system</code>, and <code>provided</code>. Used to
+ calculate the various classpaths used for compilation, testing, and so on.
+ It also assists in determining which artifacts to include in a distribution of
+ this project. For more information, see
+ <a href="http://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html">the
+ dependency mechanism</a>.
+ ]]>
+ </description>
+ <type>String</type>
+ <!-- This default has to be enforced at the maven-artifact layer, to allow
+ | injection of defaults from <dependencyManagement/>.
+ | TODO: how can we document it?
+ |-->
+ <!-- defaultValue>compile</defaultValue -->
+ </field>
+ <field xml.attribute="true">
+ <name>systemPath</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ FOR SYSTEM SCOPE ONLY. Note that use of this property is <b>discouraged</b>
+ and may be replaced in later versions. This specifies the path on the filesystem
+ for this dependency.
+ Requires an absolute path for the value, not relative.
+ Use a property that gives the machine specific absolute path,
+ e.g. <code>${java.home}</code>.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
<field>
<name>exclusions</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Lists a set of artifacts that should be excluded from this
dependency's artifact list when it comes to calculating
@@ -1583,24 +1944,22 @@
<type>boolean</type>
<defaultValue>false</defaultValue>
</field>
+ <field xml.attribute="true">
+ <name>optional</name>
+ <version>4.1.0+</version>
+ <description>
+ Indicates the dependency is optional for use of this
+ library. While the version of the dependency will be taken
+ into account for dependency calculation if the library is
+ used elsewhere, it will not be passed on transitively.
+ </description>
+ <type>boolean</type>
+ <defaultValue>false</defaultValue>
+ </field>
</fields>
<codeSegments>
<codeSegment>
- <version>3.0.0</version>
- <code>
- <![CDATA[
- /**
- * @see java.lang.Object#toString()
- */
- public String toString()
- {
- return groupId + "/" + type + "s:" + artifactId + "-" + version;
- }
- ]]>
- </code>
- </codeSegment>
- <codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
/**
@@ -1610,13 +1969,7 @@
{
return "Dependency {groupId=" + groupId + ", artifactId=" + artifactId + ", version=" + version + ", type=" + type + "}";
}
- ]]>
- </code>
- </codeSegment>
- <codeSegment>
- <version>4.0.0</version>
- <code>
- <![CDATA[
+
/**
* @return the management key as <code>groupId:artifactId:type</code>
*/
@@ -1632,6 +1985,14 @@
<code>
<![CDATA[
/**
+ * @see java.lang.Object#toString()
+ */
+ public String toString()
+ {
+ return groupId + "/" + type + "s:" + artifactId + "-" + version;
+ }
+
+ /**
* @return the key as <code>id:type</code>
*/
public String getKey()
@@ -1746,7 +2107,17 @@
<fields>
<field>
<name>id</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
+ <description>
+ <![CDATA[
+ The unique ID of the developer in the SCM.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>id</name>
+ <version>4.1.0+</version>
<description>
<![CDATA[
The unique ID of the developer in the SCM.
@@ -1758,7 +2129,7 @@
</class>
<class>
<name>Exclusion</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The <code><exclusion></code> element contains informations required to exclude
@@ -1788,6 +2159,28 @@
<type>String</type>
<required>true</required>
</field>
+ <field xml.attribute="true">
+ <name>artifactId</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The artifact ID of the project to exclude.
+ ]]>
+ </description>
+ <type>String</type>
+ <required>true</required>
+ </field>
+ <field xml.attribute="true">
+ <name>groupId</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The group ID of the project to exclude.
+ ]]>
+ </description>
+ <type>String</type>
+ <required>true</required>
+ </field>
</fields>
</class>
<class>
@@ -1796,7 +2189,7 @@
Information about the issue tracking (or bug tracking) system
used to manage this project.
</description>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<fields>
<field>
<name>system</name>
@@ -1818,11 +2211,31 @@
</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>system</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The name of the issue management system, e.g. Bugzilla
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>url</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ URL for the issue management system used by the project.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
</fields>
</class>
<class>
<name>DistributionManagement</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
This elements describes all that pertains to distribution for a project.
@@ -1833,7 +2246,7 @@
<fields>
<field>
<name>repository</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Information needed to deploy the artifacts generated by the project to a remote repository.
@@ -1845,7 +2258,7 @@
</field>
<field>
<name>snapshotRepository</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Where to deploy snapshots of artifacts to. If not given, it defaults to the
@@ -1863,14 +2276,27 @@
Information needed for deploying the web site of the project.
]]>
</description>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<association>
<type>Site</type>
</association>
</field>
<field>
<name>downloadUrl</name>
- <version>4.0.0+</version>
+ <version>4.0.0</version>
+ <description>
+ <![CDATA[
+ The URL of the project's download page. If not given users will be
+ referred to the homepage given by <code>url</code>.
+ This is given to assist in locating artifacts that are not in the repository due to
+ licensing restrictions.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>downloadUrl</name>
+ <version>4.1.0+</version>
<description>
<![CDATA[
The URL of the project's download page. If not given users will be
@@ -1883,7 +2309,7 @@
</field>
<field>
<name>relocation</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Relocation information of the artifact if it has been moved
to a new group ID and/or artifact ID.
@@ -1909,6 +2335,23 @@
<required>false</required>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>status</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ Gives the status of this artifact in the remote repository.
+ This must not be set in your local project, as it is updated by
+ tools placing it in the reposiory. Valid values are: <code>none</code> (default),
+ <code>converted</code> (repository manager converted this from an Maven 1 POM),
+ <code>partner</code>
+ (directly synced from a partner Maven 2 repository), <code>deployed</code> (was deployed from a Maven 2
+ instance), <code>verified</code> (has been hand verified as correct and final).
+ ]]>
+ </description>
+ <required>false</required>
+ <type>String</type>
+ </field>
</fields>
</class>
<class>
@@ -1925,7 +2368,7 @@
<fields>
<field>
<name>name</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The full legal name of the license.
@@ -1935,7 +2378,7 @@
</field>
<field>
<name>url</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The official url for the license text.
@@ -1945,7 +2388,7 @@
</field>
<field>
<name>distribution</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The primary method by which this project may be distributed.
@@ -1964,7 +2407,51 @@
<description>
Addendum information pertaining to this license.
</description>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>name</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The full legal name of the license.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>url</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The official url for the license text.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>distribution</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The primary method by which this project may be distributed.
+ <dl>
+ <dt>repo</dt>
+ <dd>may be downloaded from the Maven repository</dd>
+ <dt>manual</dt>
+ <dd>user must manually download and install the dependency.</dd>
+ </dl>
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>comments</name>
+ <description>
+ Addendum information pertaining to this license.
+ </description>
+ <version>4.1.0+</version>
<type>String</type>
</field>
</fields>
@@ -1981,7 +2468,7 @@
<fields>
<field>
<name>name</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The name of the mailing list.
@@ -1991,7 +2478,7 @@
</field>
<field>
<name>subscribe</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The email address or link that can be used to subscribe to the mailing list.
@@ -2004,7 +2491,7 @@
</field>
<field>
<name>unsubscribe</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The email address or link that can be used to unsubscribe to
@@ -2017,7 +2504,7 @@
</field>
<field>
<name>post</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The email address or link that can be used to post to
@@ -2030,7 +2517,7 @@
</field>
<field>
<name>archive</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The link to a URL where you can browse the mailing list archive.
@@ -2051,6 +2538,65 @@
<multiplicity>*</multiplicity>
</association>
</field>
+ <field xml.attribute="true">
+ <name>name</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The name of the mailing list.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>subscribe</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The email address or link that can be used to subscribe to the mailing list.
+ If this is an email address, a
+ <code>mailto:</code> link will automatically be created when
+ the documentation is created.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>unsubscribe</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The email address or link that can be used to unsubscribe to
+ the mailing list. If this is an email address, a
+ <code>mailto:</code> link will automatically be created
+ when the documentation is created.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>post</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The email address or link that can be used to post to
+ the mailing list. If this is an email address, a
+ <code>mailto:</code> link will automatically be created
+ when the documentation is created.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>archive</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The link to a URL where you can browse the mailing list archive.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
</fields>
<comment>
We could probably have a specific element for a dev mailing list
@@ -2068,7 +2614,7 @@
<fields>
<field>
<name>name</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
The full name of the organization.
@@ -2078,7 +2624,27 @@
</field>
<field>
<name>url</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
+ <description>
+ <![CDATA[
+ The URL to the organization's home page.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>name</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The full name of the organization.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>url</name>
+ <version>4.1.0+</version>
<description>
<![CDATA[
The URL to the organization's home page.
@@ -2168,7 +2734,7 @@
</class>
<class>
<name>Parent</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The <code><parent></code> element contains informations required to the parent project.
@@ -2177,7 +2743,58 @@
<fields>
<field>
<name>artifactId</name>
- <version>4.0.0</version>
+ <version>4.0.0</version>
+ <description>
+ <![CDATA[
+ The artifact id of the parent project to inherit from.
+ ]]>
+ </description>
+ <required>true</required>
+ <type>String</type>
+ </field>
+ <field>
+ <name>groupId</name>
+ <version>4.0.0</version>
+ <description>
+ <![CDATA[
+ The group id of the parent project to inherit from.
+ ]]>
+ </description>
+ <required>true</required>
+ <type>String</type>
+ </field>
+ <field>
+ <name>version</name>
+ <version>4.0.0</version>
+ <description>
+ <![CDATA[
+ The version of the parent project to inherit.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field>
+ <name>relativePath</name>
+ <version>4.0.0</version>
+ <description>
+ <![CDATA[
+ The relative path of the parent <code>pom.xml</code> file within the check out.
+ The default value is <code>../pom.xml</code>.
+ Maven looks for the parent pom first in the reactor of currently building projects, then in this location on
+ the filesystem, then the local repository, and lastly in the remote repo.
+ <code>relativePath</code> allows you to select a different location,
+ for example when your structure is flat, or deeper without an intermediate parent pom.
+ However, the group ID, artifact ID and version are still required,
+ and must match the file in the location given or it will revert to the repository for the POM.
+ This feature is only for enhancing the development in a local checkout of that project.
+ ]]>
+ </description>
+ <type>String</type>
+ <defaultValue>../pom.xml</defaultValue>
+ </field>
+ <field xml.attribute="true">
+ <name>artifactId</name>
+ <version>4.1.0+</version>
<description>
<![CDATA[
The artifact id of the parent project to inherit from.
@@ -2186,9 +2803,9 @@
<required>true</required>
<type>String</type>
</field>
- <field>
+ <field xml.attribute="true">
<name>groupId</name>
- <version>4.0.0</version>
+ <version>4.1.0+</version>
<description>
<![CDATA[
The group id of the parent project to inherit from.
@@ -2197,9 +2814,9 @@
<required>true</required>
<type>String</type>
</field>
- <field>
+ <field xml.attribute="true">
<name>version</name>
- <version>4.0.0</version>
+ <version>4.1.0+</version>
<description>
<![CDATA[
The version of the parent project to inherit.
@@ -2207,9 +2824,9 @@
</description>
<type>String</type>
</field>
- <field>
+ <field xml.attribute="true">
<name>relativePath</name>
- <version>4.0.0</version>
+ <version>4.1.0+</version>
<description>
<![CDATA[
The relative path of the parent <code>pom.xml</code> file within the check out.
@@ -2229,7 +2846,7 @@
</fields>
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
/**
@@ -2305,7 +2922,7 @@
</class>
<class>
<name>Scm</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The <code><scm></code> element contains informations required to the SCM
@@ -2360,6 +2977,53 @@
</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>connection</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The source control management system URL
+ that describes the repository and how to connect to the
+ repository. For more information, see the
+ <a href="http://maven.apache.org/scm/scm-url-format.html">URL format</a>
+ and <a href="http://maven.apache.org/scm/scms-overview.html">list of supported SCMs</a>.
+ This connection is read-only.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>developerConnection</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ Just like <code>connection</code>, but for developers, i.e. this scm connection
+ will not be read only.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>tag</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The tag of current code. By default, it's set to HEAD during development.
+ ]]>
+ </description>
+ <type>String</type>
+ <defaultValue>HEAD</defaultValue>
+ </field>
+ <field xml.attribute="true">
+ <name>url</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The URL to the project's browsable SCM repository, such as ViewVC or Fisheye.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
</fields>
</class>
<class>
@@ -2374,7 +3038,18 @@
<fields>
<field>
<name>directory</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
+ <description>
+ <![CDATA[
+ Describe the directory where the resources are stored.
+ The path is relative to the POM.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>directory</name>
+ <version>4.1.0+</version>
<description>
<![CDATA[
Describe the directory where the resources are stored.
@@ -2398,7 +3073,7 @@
<fields>
<field>
<name>targetPath</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
<description>
<![CDATA[
Describe the resource target path. The path is relative to the target/classes
@@ -2414,7 +3089,36 @@
</field>
<field>
<name>filtering</name>
- <version>3.0.0+</version>
+ <version>3.0.0/4.0.0</version>
+ <description>
+ <![CDATA[
+ Whether resources are filtered to replace tokens with parameterised values or not.
+ The values are taken from the <code>properties</code> element and from the
+ properties in the files listed in the <code>filters</code> element.
+ ]]>
+ </description>
+ <type>boolean</type>
+ <defaultValue>false</defaultValue>
+ </field>
+ <field xml.attribute="true">
+ <name>targetPath</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ Describe the resource target path. The path is relative to the target/classes
+ directory (i.e. <code>${project.build.outputDirectory}</code>).
+ For example, if you want that resource to appear in a specific package
+ (<code>org.apache.maven.messages</code>), you must specify this
+ element with this value: <code>org/apache/maven/messages</code>.
+ This is not required if you simply put the resources in that directory
+ structure at the source, however.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>filtering</name>
+ <version>4.1.0+</version>
<description>
<![CDATA[
Whether resources are filtered to replace tokens with parameterised values or not.
@@ -2558,7 +3262,7 @@
<class>
<name>RepositoryBase</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
A repository contains the information needed
@@ -2609,10 +3313,53 @@
<type>String</type>
<defaultValue>default</defaultValue>
</field>
+ <field xml.attribute="true">
+ <name>id</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ A unique identifier for a repository. This is used to match the repository
+ to configuration in the <code>settings.xml</code> file, for example.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>name</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ Human readable name of the repository.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>url</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The url of the repository, in the form <code>protocol://hostname/path</code>.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>layout</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The type of layout this repository uses for locating and storing artifacts -
+ can be <code>legacy</code> or <code>default</code>.
+ ]]>
+ </description>
+ <type>String</type>
+ <defaultValue>default</defaultValue>
+ </field>
</fields>
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
/**
@@ -2642,7 +3389,7 @@
<class>
<name>Repository</name>
<superClass>RepositoryBase</superClass>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
A repository contains the information needed for establishing
connections with remote repository.
@@ -2650,7 +3397,7 @@
<fields>
<field>
<name>releases</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
How to handle downloading of releases from this repository.
</description>
@@ -2660,7 +3407,7 @@
</field>
<field>
<name>snapshots</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
How to handle downloading of snapshots from this repository.
</description>
@@ -2672,7 +3419,7 @@
<!-- TODO:prevent modello generation of an incorrect equals method. Could be avoided by using <identity/> tags to mark ID as the only identity field -->
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
/**
@@ -2691,7 +3438,7 @@
<class>
<name>DeploymentRepository</name>
<superClass>RepositoryBase</superClass>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Repository contains the information needed for deploying to the
remote repository.
@@ -2708,11 +3455,22 @@
<defaultValue>true</defaultValue>
<version>4.0.0</version>
</field>
+ <field xml.attribute="true">
+ <name>uniqueVersion</name>
+ <description>
+ Whether to assign snapshots a unique version comprised of
+ the timestamp and build number, or to use the same version
+ each time
+ </description>
+ <type>boolean</type>
+ <defaultValue>true</defaultValue>
+ <version>4.1.0+</version>
+ </field>
</fields>
<!-- TODO:prevent modello generation of an incorrect equals method. Could be avoided by using <identity/> tags to mark ID as the only identity field -->
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
/**
@@ -2730,7 +3488,7 @@
<class>
<name>RepositoryPolicy</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Download policy.
</description>
@@ -2778,13 +3536,56 @@
</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>enabled</name>
+ <version>4.1.0+</version>
+ <description>
+ Whether to use this repository for downloading this type of
+ artifact.
+ </description>
+ <type>boolean</type>
+ <defaultValue>true</defaultValue>
+ </field>
+ <field xml.attribute="true">
+ <name>updatePolicy</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The frequency for downloading updates - can be
+ <code>always,</code>
+ <code>daily</code>
+ (default),
+ <code>interval:XXX</code>
+ (in minutes) or
+ <code>never</code>
+ (only if it doesn't exist locally).
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>checksumPolicy</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ What to do when verification of an artifact checksum fails. Valid values are
+ <code>ignore</code>
+ ,
+ <code>fail</code>
+ or
+ <code>warn</code>
+ (the default).
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
</fields>
</class>
<!--@todo find better solution for management of site deployments -->
<class>
<name>Site</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Contains the information needed for deploying websites.
@@ -2822,12 +3623,43 @@
</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>id</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ A unique identifier for a deployment location. This is used to match the
+ site to configuration in the <code>settings.xml</code> file, for example.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>name</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ Human readable name of the deployment location.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>url</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The url of the location where website is deployed, in the form <code>protocol://hostname/path</code>.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
</fields>
</class>
<class>
<name>ConfigurationContainer</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Contains the configuration information of the container like Plugin.
@@ -2844,6 +3676,16 @@
</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>inherited</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ Whether any configuration should be propagated to child POMs.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
<field>
<description>
<![CDATA[
@@ -2852,11 +3694,12 @@
</description>
<name>configuration</name>
<type>DOM</type>
+ <version>4.0.0+</version>
</field>
</fields>
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
private boolean inheritanceApplied = true;
@@ -2877,7 +3720,7 @@
</class>
<class>
<name>Plugin</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<superClass>ConfigurationContainer</superClass>
<description>
<![CDATA[
@@ -2926,9 +3769,50 @@
</description>
<defaultValue>false</defaultValue>
</field>
+ <field xml.attribute="true">
+ <name>groupId</name>
+ <description>
+ The group ID of the plugin in the repository.
+ </description>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <required>true</required>
+ <defaultValue>org.apache.maven.plugins</defaultValue>
+ </field>
+ <field xml.attribute="true">
+ <name>artifactId</name>
+ <description>
+ The artifact ID of the plugin in the repository.
+ </description>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <required>true</required>
+ </field>
+ <field xml.attribute="true">
+ <name>version</name>
+ <version>4.1.0+</version>
+ <required>true</required>
+ <description>
+ <![CDATA[
+ The version (or valid range of versions) of the plugin to be used.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>extensions</name>
+ <version>4.1.0+</version>
+ <type>boolean</type>
+ <description>
+ Whether to load Maven extensions (such as packaging and type
+ handlers) from this plugin. For performance reasons, this
+ should only be enabled when necessary.
+ </description>
+ <defaultValue>false</defaultValue>
+ </field>
<field>
<name>executions</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Multiple specifications of a set of goals to execute during
the build lifecycle, each having (possibly) a different
@@ -2945,7 +3829,7 @@
Additional dependencies that this project needs to introduce
to the plugin's classloader.
</description>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<association>
<type>Dependency</type>
<multiplicity>*</multiplicity>
@@ -2964,7 +3848,7 @@
</fields>
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
private java.util.Map executionMap = null;
@@ -3060,7 +3944,7 @@
</class>
<class>
<name>PluginExecution</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<superClass>ConfigurationContainer</superClass>
<description>
<![CDATA[
@@ -3091,9 +3975,31 @@
default phase specified in their metadata.
</description>
</field>
+ <field xml.attribute="true">
+ <name>id</name>
+ <version>4.1.0+</version>
+ <required>true</required>
+ <type>String</type>
+ <defaultValue>default</defaultValue>
+ <description>
+ The identifier of this execution for labelling the goals
+ during the build, and for matching executions to merge during
+ inheritance.
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>phase</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ The build lifecycle phase to bind the goals in this
+ execution to. If omitted, the goals will be bound to the
+ default phase specified in their metadata.
+ </description>
+ </field>
<field>
<name>goals</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
The goals to execute with the given configuration.
</description>
@@ -3105,7 +4011,7 @@
</fields>
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
public static final String DEFAULT_EXECUTION_ID = "default";
@@ -3116,7 +4022,7 @@
</class>
<class>
<name>DependencyManagement</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Section for management of default dependency information for use
in a group of POMs.
@@ -3124,7 +4030,7 @@
<fields>
<field>
<name>dependencies</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
The dependencies specified here are not used until they are
referenced in a POM within the group. This allows the
@@ -3140,7 +4046,7 @@
</class>
<class>
<name>PluginManagement</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<superClass>PluginContainer</superClass>
<description>
Section for management of default plugin information for use in
@@ -3149,7 +4055,7 @@
</class>
<class>
<name>Reporting</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Section for management of reports and their configuration.
</description>
@@ -3178,9 +4084,33 @@
</description>
<!-- TODO: why isn't default set here? -->
</field>
+ <field xml.attribute="true">
+ <name>excludeDefaults</name>
+ <version>4.1.0+</version>
+ <type>boolean</type>
+ <description>
+ If true, then the default reports are not included in the
+ site generation. This includes the reports in the "Project
+ Info" menu.
+ </description>
+ <defaultValue>false</defaultValue>
+ </field>
+ <field xml.attribute="true">
+ <name>outputDirectory</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ <![CDATA[
+ Where to store all of the generated reports. The default is
+ <code>${project.build.directory}/site</code>
+ .
+ ]]>
+ </description>
+ <!-- TODO: why isn't default set here? -->
+ </field>
<field>
<name>plugins</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
The reporting plugins to use and their configuration.
</description>
@@ -3192,7 +4122,7 @@
</fields>
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
java.util.Map reportPluginMap;
@@ -3235,7 +4165,7 @@
<class>
<name>Profile</name>
<superClass>ModelBase</superClass>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Modifications to the build process which is activated based on environmental
@@ -3254,9 +4184,20 @@
to merge with during inheritance.
</description>
</field>
+ <field xml.attribute="true">
+ <name>id</name>
+ <required>true</required>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ The identifier of this build profile. This used both for
+ command line activation, and identifies identical profiles
+ to merge with during inheritance.
+ </description>
+ </field>
<field>
<name>activation</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The conditional logic which will automatically
@@ -3269,7 +4210,7 @@
</field>
<field xml.tagName="build">
<name>build</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<required>true</required>
<description>
<![CDATA[
@@ -3283,7 +4224,7 @@
</fields>
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
// We don't want this to be parseable...it's sort of 'hidden'
@@ -3314,7 +4255,7 @@
</class>
<class>
<name>Activation</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The conditions within the build runtime environment which will trigger
@@ -3342,9 +4283,30 @@
]]>
</description>
</field>
+ <field xml.attribute="true">
+ <name>activeByDefault</name>
+ <version>4.1.0+</version>
+ <type>boolean</type>
+ <description>
+ Flag specifying whether this profile is active by default.
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>jdk</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ <![CDATA[
+ Specifies that this profile will be activated when a matching JDK is detected.
+ For example, <code>1.4</code> only activates on JDKs versioned 1.4,
+ while <code>!1.4</code> matches any JDK that is not version 1.4.
+ ]]>
+ </description>
+ </field>
+ <!-- TODO [BP]: can these ones be flattened in some way? -->
<field>
<name>os</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Specifies that this profile will be activated when matching operating
@@ -3357,7 +4319,7 @@
</field>
<field>
<name>property</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Specifies that this profile will be activated when this system property is specified.
@@ -3369,7 +4331,7 @@
</field>
<field>
<name>file</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Specifies that this profile will be activated based on existence of a file.
@@ -3383,7 +4345,7 @@
</class>
<class>
<name>ActivationProperty</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
This is the property specification used to activate a profile.
@@ -3410,11 +4372,28 @@
The value of the property required to activate a profile.
</description>
</field>
+ <field xml.attribute="true">
+ <name>name</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <required>true</required>
+ <description>
+ The name of the property to be used to activate a profile.
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>value</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ The value of the property required to activate a profile.
+ </description>
+ </field>
</fields>
</class>
<class>
<name>ActivationOS</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
This is an activator which will detect an operating system's attributes in order to activate
@@ -3462,11 +4441,51 @@
the profile.
</description>
</field>
+ <field xml.attribute="true">
+ <name>name</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ <![CDATA[
+ The name of the operating system to be used to activate the profile. This must be an exact match
+ of the <code>${os.name}</code> Java property, such as <code>Windows XP</code>.
+ ]]>
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>family</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ <![CDATA[
+ The general family of the OS to be used to activate the profile, such as
+ <code>windows</code> or <code>unix</code>.
+ ]]>
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>arch</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ The architecture of the operating system to be used to
+ activate the profile.
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>version</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ The version of the operating system to be used to activate
+ the profile.
+ </description>
+ </field>
</fields>
</class>
<class>
<name>ActivationFile</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
This is the file specification used to activate the profile.
@@ -3494,12 +4513,30 @@
profile.
</description>
</field>
+ <field xml.attribute="true">
+ <name>missing</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ The name of the file that must be missing to activate the
+ profile.
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>exists</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ The name of the file that must exist to activate the
+ profile.
+ </description>
+ </field>
</fields>
</class>
<!-- /BuildProfile support -->
<class xml.tagName="plugin">
<name>ReportPlugin</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
The <code><plugin></code> element contains informations required for a report plugin.
@@ -3544,9 +4581,47 @@
available to projects that inherit from this one.
</description>
</field>
+ <field xml.attribute="true">
+ <name>groupId</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <required>true</required>
+ <defaultValue>org.apache.maven.plugins</defaultValue>
+ <description>
+ The group ID of the reporting plugin in the repository.
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>artifactId</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <required>true</required>
+ <description>
+ The artifact ID of the reporting plugin in the repository.
+ </description>
+ </field>
+ <field xml.attribute="true">
+ <name>version</name>
+ <version>4.1.0+</version>
+ <description>
+ <![CDATA[
+ The version of the reporting plugin to be used.
+ ]]>
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>inherited</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ Whether the configuration in this plugin should be made
+ available to projects that inherit from this one.
+ </description>
+ </field>
<field>
<name>configuration</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<type>DOM</type>
<description>
The configuration of the reporting plugin.
@@ -3554,7 +4629,7 @@
</field>
<field>
<name>reportSets</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
<![CDATA[
Multiple specifications of a set of reports, each having (possibly) different
@@ -3569,7 +4644,7 @@
</fields>
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
private java.util.Map reportSetMap = null;
@@ -3640,7 +4715,7 @@
</class>
<class>
<name>ReportSet</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Represents a set of reports and configuration to be used to
generate them.
@@ -3655,10 +4730,22 @@
inheritance.
</description>
<defaultValue>default</defaultValue>
+ <version>4.0.0</version>
+ </field>
+ <field xml.attribute="true">
+ <name>id</name>
+ <type>String</type>
+ <required>true</required>
+ <description>
+ The unique id for this report set, to be used during POM
+ inheritance.
+ </description>
+ <defaultValue>default</defaultValue>
+ <version>4.1.0+</version>
</field>
<field>
<name>configuration</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Configuration of the report to be used when generating this
set.
@@ -3675,9 +4762,19 @@
]]>
</description>
</field>
+ <field xml.attribute="true">
+ <name>inherited</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <description>
+ <![CDATA[
+ Whether any configuration should be propagated to child POMs.
+ ]]>
+ </description>
+ </field>
<field>
<name>reports</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<required>true</required>
<description>
<![CDATA[
@@ -3692,7 +4789,7 @@
</fields>
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
private boolean inheritanceApplied = true;
@@ -3713,7 +4810,7 @@
</class>
<class>
<name>Prerequisites</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Describes the prerequisites a project can have.
</description>
@@ -3729,11 +4826,23 @@
</description>
<required>false</required>
</field>
+ <field xml.attribute="">
+ <name>maven</name>
+ <version>4.1.0+</version>
+ <type>String</type>
+ <!-- TODO [BP]: replace with the version it ends up in -->
+ <defaultValue>2.0.9-SNAPSHOT</defaultValue>
+ <description>
+ The minimum version of Maven required to build the project,
+ or to use this plugin.
+ </description>
+ <required>false</required>
+ </field>
</fields>
</class>
<class>
<name>Relocation</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Describes where an artifact has moved to. If any of the values
are omitted, it is assumed to be the same as it was before.
@@ -3770,11 +4879,42 @@
</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>groupId</name>
+ <version>4.1.0+</version>
+ <description>
+ The group ID the artifact has moved to.
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>artifactId</name>
+ <version>4.1.0+</version>
+ <description>
+ The new artifact ID of the artifact.
+ </description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>version</name>
+ <version>4.1.0+</version>
+ <description>The new version of the artifact.</description>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>message</name>
+ <version>4.1.0+</version>
+ <description>
+ An additional message to show the user about the move, such
+ as the reason.
+ </description>
+ <type>String</type>
+ </field>
</fields>
</class>
<class>
<name>Extension</name>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<description>
Describes a build extension to utilise.
</description>
@@ -3801,10 +4941,32 @@
<description>The version of the extension.</description>
<type>String</type>
</field>
+ <field xml.attribute="true">
+ <name>groupId</name>
+ <version>4.1.0+</version>
+ <description>
+ The group ID of the extension's artifact.
+ </description>
+ <required>true</required>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>artifactId</name>
+ <version>4.1.0+</version>
+ <description>The artifact ID of the extension.</description>
+ <required>true</required>
+ <type>String</type>
+ </field>
+ <field xml.attribute="true">
+ <name>version</name>
+ <version>4.1.0+</version>
+ <description>The version of the extension.</description>
+ <type>String</type>
+ </field>
</fields>
<codeSegments>
<codeSegment>
- <version>4.0.0</version>
+ <version>4.0.0+</version>
<code>
<![CDATA[
/**
Modified: maven/components/branches/maven-2.0.x-terse/maven-plugin-descriptor/pom.xml
URL: http://svn.apache.org/viewvc/maven/components/branches/maven-2.0.x-terse/maven-plugin-descriptor/pom.xml?rev=620422&r1=620421&r2=620422&view=diff
==============================================================================
--- maven/components/branches/maven-2.0.x-terse/maven-plugin-descriptor/pom.xml (original)
+++ maven/components/branches/maven-2.0.x-terse/maven-plugin-descriptor/pom.xml Sun Feb 10 22:01:36 2008
@@ -37,6 +37,16 @@
<model>src/main/mdo/lifecycle.mdo</model>
<version>1.0.0</version>
</configuration>
+ <executions>
+ <execution>
+ <id>standard</id>
+ <goals>
+ <goal>java</goal>
+ <goal>xpp3-reader</goal>
+ <goal>xpp3-writer</goal>
+ </goals>
+ </execution>
+ </executions>
</plugin>
</plugins>
</build>
Modified: maven/components/branches/maven-2.0.x-terse/maven-plugin-parameter-documenter/pom.xml
URL: http://svn.apache.org/viewvc/maven/components/branches/maven-2.0.x-terse/maven-plugin-parameter-documenter/pom.xml?rev=620422&r1=620421&r2=620422&view=diff
==============================================================================
--- maven/components/branches/maven-2.0.x-terse/maven-plugin-parameter-documenter/pom.xml (original)
+++ maven/components/branches/maven-2.0.x-terse/maven-plugin-parameter-documenter/pom.xml Sun Feb 10 22:01:36 2008
@@ -37,6 +37,16 @@
<version>1.0.0</version>
<model>src/main/mdo/paramdoc.mdo</model>
</configuration>
+ <executions>
+ <execution>
+ <id>standard</id>
+ <goals>
+ <goal>java</goal>
+ <goal>xpp3-reader</goal>
+ <goal>xpp3-writer</goal>
+ </goals>
+ </execution>
+ </executions>
</plugin>
</plugins>
</build>
Modified: maven/components/branches/maven-2.0.x-terse/maven-plugin-registry/pom.xml
URL: http://svn.apache.org/viewvc/maven/components/branches/maven-2.0.x-terse/maven-plugin-registry/pom.xml?rev=620422&r1=620421&r2=620422&view=diff
==============================================================================
--- maven/components/branches/maven-2.0.x-terse/maven-plugin-registry/pom.xml (original)
+++ maven/components/branches/maven-2.0.x-terse/maven-plugin-registry/pom.xml Sun Feb 10 22:01:36 2008
@@ -37,6 +37,16 @@
<version>1.0.0</version>
<model>plugin-registry.mdo</model>
</configuration>
+ <executions>
+ <execution>
+ <id>standard</id>
+ <goals>
+ <goal>java</goal>
+ <goal>xpp3-reader</goal>
+ <goal>xpp3-writer</goal>
+ </goals>
+ </execution>
+ </executions>
</plugin>
</plugins>
</build>