o improved javadoc

git-svn-id: https://svn.apache.org/repos/asf/maven/plugin-tools/trunk@617680 13f79535-47bb-0310-9956-ffa450edef68

maven-plugin-tools-api/src/main/java/org/apache/maven/tools/plugin/generator/Generator.java

@@ -25,11 +25,20 @@ import java.io.File;
 import java.io.IOException;
 
 /**
+ * Generate something, for instance a plugin report, from a plugin descriptor.
+ *
  * @author <a href="mailto:jason@maven.org">Jason van Zyl </a>
  * @version $Id$
  */
 public interface Generator
 {
+    /**
+     * Execute the generation for a given plugin descriptor.
+     *
+     * @param destinationDirectory required
+     * @param pluginDescriptor required
+     * @throws IOException if any
+     */
     void execute( File destinationDirectory, PluginDescriptor pluginDescriptor )
         throws IOException;
 }

maven-plugin-tools-api/src/main/java/org/apache/maven/tools/plugin/generator/PluginXdocGenerator.java

@@ -35,11 +35,12 @@ import java.util.List;
 
 /**
  * @todo add example usage tag that can be shown in the doco
+ * @version $Id$
  */
 public class PluginXdocGenerator
     implements Generator
 {
-
+    /** {@inheritDoc} */
     public void execute( File destinationDirectory, PluginDescriptor pluginDescriptor )
         throws IOException
     {