fixing some javadoc, remaining are due to Modello so skip javadoc fai…

…lure Signed-off-by: olivier lamy <[email protected]>
apache · Oct 25, 2018 · 26ba032 · 26ba032
1 parent 6b3122c
commit 26ba032
Show file tree

Hide file tree

Showing 6 changed files with 225 additions and 74 deletions.
diff --git a/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/AbstractGeneratorMojo.java b/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/AbstractGeneratorMojo.java
@@ -92,13 +92,14 @@ public abstract class AbstractGeneratorMojo
     protected boolean skipErrorNoDescriptorsFound;
 
     /**
+     * <p>
      * The role names of mojo extractors to use.
-     * <p/>
+     * </p>
+     * <p>
      * If not set, all mojo extractors will be used. If set to an empty extractor name, no mojo extractors
      * will be used.
-     * <p/>
+     * </p>
      * Example:
-     * <p/>
      * <pre>
      *  &lt;!-- Use all mojo extractors --&gt;
      *  &lt;extractors/&gt;

diff --git a/...n-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/DescriptorGeneratorMojo.java b/...n-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/DescriptorGeneratorMojo.java
@@ -29,14 +29,16 @@
 import org.apache.maven.tools.plugin.generator.PluginDescriptorGenerator;
 
 /**
+ * <p>
  * Generate a plugin descriptor.
- * <br/>
+ * </p>
+ * <p>
  * <b>Note:</b> Since 3.0, for Java plugin annotations support,
  * default <a href="http://maven.apache.org/ref/current/maven-core/lifecycles.html">phase</a>
  * defined by this goal is after the "compilation" of any scripts. This doesn't override
  * <a href="/ref/current/maven-core/default-bindings.html#Bindings_for_maven-plugin_packaging">the default binding coded
  * at generate-resources phase</a> in Maven core.
- *
+ * </p>
  * @author <a href="mailto:[email protected]">Jason van Zyl</a>
  * @since 2.0
  */

diff --git a/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/PluginReport.java b/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/PluginReport.java
@@ -136,12 +136,15 @@ public class PluginReport
     private Requirements requirements;
 
     /**
+     * <p>
      * The goal prefix that will appear before the ":".
      * By default, this plugin applies a heuristic to derive a heuristic from
      * the plugin's artifactId.
-     * <p/>
+     * </p>
+     * <p>
      * It removes any occurrences of the regular expression <strong>-?maven-?</strong>,
      * and then removes any occurrences of <strong>-?plugin-?</strong>.
+     * </p>
      * <p>
      * For example, horsefeature-maven-plugin becomes horsefeature.
      * </p>

diff --git a/...a/org/apache/maven/tools/plugin/extractor/javadoc/JavaJavadocMojoDescriptorExtractor.java b/...a/org/apache/maven/tools/plugin/extractor/javadoc/JavaJavadocMojoDescriptorExtractor.java
@@ -53,8 +53,9 @@
 import com.thoughtworks.qdox.model.JavaType;
 
 /**
+ * <p>
  * Extracts Mojo descriptors from <a href="http://java.sun.com/">Java</a> sources.
- * <br/>
+ * </p>
  * For more information about the usage tag, have a look to:
  * <a href="http://maven.apache.org/developers/mojo-api-specification.html">
  * http://maven.apache.org/developers/mojo-api-specification.html</a>