Repository: maven Updated Branches: refs/heads/MNG-6185 [created] 63796a649
[MNG-6185] Replace doclettag explanation with annotations in AbstractMojo javadoc Project: http://git-wip-us.apache.org/repos/asf/maven/repo Commit: http://git-wip-us.apache.org/repos/asf/maven/commit/63796a64 Tree: http://git-wip-us.apache.org/repos/asf/maven/tree/63796a64 Diff: http://git-wip-us.apache.org/repos/asf/maven/diff/63796a64 Branch: refs/heads/MNG-6185 Commit: 63796a649e6e3b25a58fb567d354ca1849f48819 Parents: 8400984 Author: rfscholte <rfscho...@apache.org> Authored: Sat Mar 25 23:15:00 2017 +0100 Committer: rfscholte <rfscho...@apache.org> Committed: Sat Mar 25 23:15:00 2017 +0100 ---------------------------------------------------------------------- .../org/apache/maven/plugin/AbstractMojo.java | 35 +++++++++----------- 1 file changed, 15 insertions(+), 20 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/maven/blob/63796a64/maven-plugin-api/src/main/java/org/apache/maven/plugin/AbstractMojo.java ---------------------------------------------------------------------- diff --git a/maven-plugin-api/src/main/java/org/apache/maven/plugin/AbstractMojo.java b/maven-plugin-api/src/main/java/org/apache/maven/plugin/AbstractMojo.java index f85e7f3..8640995 100644 --- a/maven-plugin-api/src/main/java/org/apache/maven/plugin/AbstractMojo.java +++ b/maven-plugin-api/src/main/java/org/apache/maven/plugin/AbstractMojo.java @@ -27,17 +27,15 @@ import org.apache.maven.plugin.logging.SystemStreamLog; /** * Abstract class to provide most of the infrastructure required to implement a <code>Mojo</code> except for * the execute method.<br> - * The implementation should have a <code>goal</code> annotation in the class-level javadoc annotation: + * The implementation should have a <code>Mojo</code> annotation with the name of the goal: * <pre> - * /** - * * @goal goalName - * */ + * @Mojo( name = "<goal-name>" ) * </pre> * <p> - * There are also a number of class-level javadoc annotations which can be used to control how and when the + * There are also a number of attributes which can be used to control how and when the * <code>Mojo</code> is executed: * </p> - * <table border="1" summary="class-level doclettags"> + * <table border="1" summary="mojo annotation attributes"> * <tr bgcolor="#CCCCCC"> * <th>Descriptor Element</th> * <th>Annotation</th> @@ -46,7 +44,7 @@ import org.apache.maven.plugin.logging.SystemStreamLog; * </tr> * <tr> * <td>goal</td> - * <td>@goal <goalName></td> + * <td>name = "<goal-name>"</td> * <td>Yes</td> * <td>The name for the Mojo that users will reference from the command line to execute the Mojo directly, * or inside a POM in order to provide Mojo-specific configuration.</td> @@ -65,7 +63,7 @@ import org.apache.maven.plugin.logging.SystemStreamLog; * </tr> * <tr> * <td>configurator</td> - * <td>@configurator <roleHint></td> + * <td>configurator = "<role-hint>"</td> * <td>No</td> * <td>The configurator type to use when injecting parameter values into this Mojo. The value is normally * deduced from the Mojo's implementation language, but can be specified to allow a custom @@ -77,7 +75,7 @@ import org.apache.maven.plugin.logging.SystemStreamLog; * </tr> * <tr> * <td>phase</td> - * <td>@phase <phaseName></td> + * <td>defaultPhase = LifecyclePhase.<phase></td> * <td>No</td> * <td>Binds this Mojo to a particular phase of the standard build lifecycle, if specified. * <br> @@ -86,7 +84,7 @@ import org.apache.maven.plugin.logging.SystemStreamLog; * </tr> * <tr> * <td>execute</td> - * <td>@execute [phase=<phaseName>|goal=<goalName>] [lifecycle=<lifecycleId>]</td> + * <td>@Execute ( phase=LifecyclePhase.<phase>, goal= "<goal-name>", lifecycle="<lifecycle-id>" )</td> * <td>No</td> * <td>When this goal is invoked, it will first invoke a parallel lifecycle, ending at the given phase. * If a goal is provided instead of a phase, that goal will be executed in isolation. @@ -99,7 +97,7 @@ import org.apache.maven.plugin.logging.SystemStreamLog; * </tr> * <tr> * <td>requiresDependencyResolution</td> - * <td>@requiresDependencyResolution <requiredScope></td> + * <td>requiresDependencyResolution = ResolutionScope.<scope></td> * <td>No</td> * <td>Flags this Mojo as requiring the dependencies in the specified scope (or an implied scope) to be * resolved before it can execute. @@ -128,6 +126,8 @@ import org.apache.maven.plugin.logging.SystemStreamLog; * </td> * </tr> * </table> + * <p>This is only a small set of all the options. A complete list can be found at + * <a href="https://maven.apache.org/components/plugin-tools/maven-plugin-tools-annotations/index.html" target="_blank">Maven Plugin Tool for Annotations</a>. * * @see <a href="https://maven.apache.org/guides/plugin/guide-java-plugin-development.html" target="_blank">Guide to Developing Java Plugins</a> * @see <a href="https://maven.apache.org/guides/mini/guide-configuring-plugins.html" target="_blank">Guide to Configuring Plug-ins</a> @@ -146,9 +146,7 @@ public abstract class AbstractMojo /** Plugin container context */ private Map pluginContext; - /** - * @see org.apache.maven.plugin.Mojo#setLog(org.apache.maven.plugin.logging.Log) - */ + @Override public void setLog( Log log ) { this.log = log; @@ -167,6 +165,7 @@ public abstract class AbstractMojo * * @see org.apache.maven.plugin.Mojo#getLog() */ + @Override public Log getLog() { if ( log == null ) @@ -177,17 +176,13 @@ public abstract class AbstractMojo return log; } - /** - * @see org.apache.maven.plugin.ContextEnabled#getPluginContext() - */ + @Override public Map getPluginContext() { return pluginContext; } - /** - * @see org.apache.maven.plugin.ContextEnabled#setPluginContext(java.util.Map) - */ + @Override public void setPluginContext( Map pluginContext ) { this.pluginContext = pluginContext;