diff --git a/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/DescriptorGeneratorMojo.java b/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/DescriptorGeneratorMojo.java
index 120bd07..7a6d884 100644
--- a/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/DescriptorGeneratorMojo.java
+++ b/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/DescriptorGeneratorMojo.java
@@ -27,7 +27,7 @@ import java.io.File;
 /**
  * Generate a plugin descriptor.
  * <p/>
- * Note: Phase is after the "compilation" of any scripts
+ * <b>Note:</b> Phase is after the "compilation" of any scripts.
  *
  * @author <a href="mailto:jason@maven.org">Jason van Zyl</a>
  * @version $Id$
@@ -40,7 +40,7 @@ public class DescriptorGeneratorMojo
     extends AbstractGeneratorMojo
 {
     /**
-     * The directory where the generated plugin.xml file will be put.
+     * The directory where the generated <code>plugin.xml</code> file will be put.
      *
      * @parameter default-value="${project.build.outputDirectory}/META-INF/maven"
      */
diff --git a/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/HelpGeneratorMojo.java b/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/HelpGeneratorMojo.java
index e009800..008e3f2 100644
--- a/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/HelpGeneratorMojo.java
+++ b/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/HelpGeneratorMojo.java
@@ -26,7 +26,7 @@ import org.apache.maven.tools.plugin.generator.Generator;
 import org.apache.maven.tools.plugin.generator.PluginHelpGenerator;
 
 /**
- * Generates an <code>HelpMojo</code> class.
+ * Generates a <code>HelpMojo</code> class.
  *
  * @author <a href="mailto:vincent.siveton@gmail.com">Vincent Siveton</a>
  * @version $Id$
diff --git a/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/UpdatePluginRegistryMojo.java b/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/UpdatePluginRegistryMojo.java
index f8432f3..43bb915 100644
--- a/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/UpdatePluginRegistryMojo.java
+++ b/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/UpdatePluginRegistryMojo.java
@@ -51,7 +51,7 @@ public class UpdatePluginRegistryMojo
     extends AbstractMojo
 {
     /**
-     * Indicates whether the plugin-registry.xml is used by Maven or not
+     * Indicates whether the <code>plugin-registry.xml</code> file is used by Maven or not
      * to manage plugin versions.
      *
      * @parameter default-value="${settings.usePluginRegistry}"
diff --git a/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/XdocGeneratorMojo.java b/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/XdocGeneratorMojo.java
index 4b9902a..033b097 100644
--- a/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/XdocGeneratorMojo.java
+++ b/maven-plugin-plugin/src/main/java/org/apache/maven/plugin/plugin/XdocGeneratorMojo.java
@@ -25,7 +25,7 @@ import org.apache.maven.tools.plugin.generator.PluginXdocGenerator;
 import java.io.File;
 
 /**
- * Generate Xdoc files for the project mojos or goals
+ * Generate Xdoc files for the project mojos or goals.
  *
  * @author <a href="mailto:brett@apache.org">Brett Porter</a>
  * @version $Id$