reworked documentation with links to javadoc

git-svn-id: https://svn.apache.org/repos/asf/maven/plugin-tools/trunk@1338436 13f79535-47bb-0310-9956-ffa450edef68
master
Herve Boutemy 2012-05-14 21:27:59 +00:00
parent be82de952e
commit 180bcb36c9
1 changed files with 9 additions and 70 deletions

View File

@ -85,77 +85,16 @@ Using Java5 annotations
* Annotations
** @Mojo
Information for plugin descriptor generation is specified using 4 annotations:
This annotation will mark your class as a Mojo.
Available attributes:
* name: goal name. Required (no default).
* defaultPhase: default phase to bind your mojo. To ease usage, this comes now from an enum. Default: none.
* requiresDependencyResolution: the needed dependency resoluation. To ease usage, this comes now from an enum. . Default: runtime.
* requiresDependencyCollection: Gets the scope of (transitive) dependencies that should be collected. To ease usage, this comes now from an enum. Default: runtime.
* executionStrategy: once-per-session or always. default: once-per-session.
* instantiationStrategy: your Mojo instantiation strategy. To ease usage, this comes now from an enum. (Only per-lookup and singleton are supported).Default: per-lookup.
* requiresProject: does your mojo requires a project to be executed. Default: true.
* requiresReports: Default: false.
* aggregator: if the Mojo uses the Maven project and its child modules. Default: false.
* requiresDirectInvocation: Get flags this Mojo to be invoked directly.. Default: false.
* requiresOnline: need to be online to be executed. Default: false.
* inheritByDefault: . Default: true.
* configurator: own configurator class. Default: none.
* threadSafe: is your mojo thread safe (since Maven 3.x). Default: false.
** @Execute
Used if your Mojo need to fork a lifecycle.
Available attributes:
* phase: phase to fork. To ease usage, this comes now from an enum. Default: none.
* goal: goal to fork. Default: none.
* lifecycle: lifecycle id to fork. Default: none.
** @Parameter
Used to configure your Mojo Parameters.
Available attributes:
* defaultValue: parameter default value. Default: none.
* expression: expression to use to retrieve a value. Can come from -D execution or pom.properties. Default: none.
* required: is parameter required. Default: false.
* readonly: is parameter readonly. Default: false.
* alias: use of alias to get parameter value. Default: none.
** @Component
Used to configure injection of Plexus components.
Available attributes:
* role: role of your component. Default: none.
* roleHint: role hint of your component. Default: none.
* required: is component required. Default: false.
* readonly: is component readonly. Default: false.
* <<<@Mojo>>>: This annotation will mark your class as a Mojo. See
{{{/plugin-tools/maven-plugin-annotations/apidocs/org/apache/maven/plugins/annotations/Mojo.html}javadoc}} for more information.
* <<<@Execute>>>: Used if your Mojo need to fork a lifecycle. See
{{{/plugin-tools/maven-plugin-annotations/apidocs/org/apache/maven/plugins/annotations/Execute.html}javadoc}} for more information.
* <<<@Parameter>>>: Used to configure your Mojo parameters. See
{{{/plugin-tools/maven-plugin-annotations/apidocs/org/apache/maven/plugins/annotations/Parameter.html}javadoc}} for more information.
* <<<@Component>>>: Used to configure injection of Plexus components. See
{{{/plugin-tools/maven-plugin-annotations/apidocs/org/apache/maven/plugins/annotations/Component.html}javadoc}} for more information.