diff --git a/jdiff/plugin.properties b/jdiff/plugin.properties
index 65203b7b..2960a3dd 100644
--- a/jdiff/plugin.properties
+++ b/jdiff/plugin.properties
@@ -17,7 +17,7 @@
 # -------------------------------------------------------------------
 # P L U G I N  P R O P E R I E S
 # -------------------------------------------------------------------
-# jdiff plugin.  use any valid cvs labels to compare between 
+# jdiff plugin.  use any valid tag names to compare between 
 # or 'CURRENT' to compare against your current filesystem. 
 # -------------------------------------------------------------------
 maven.jdiff.old.tag=CURRENT
diff --git a/jdiff/xdocs/index.xml b/jdiff/xdocs/index.xml
index 51352449..6fcbfa3e 100644
--- a/jdiff/xdocs/index.xml
+++ b/jdiff/xdocs/index.xml
@@ -20,7 +20,7 @@
 
 <document>
   <properties>
-    <title>Maven NSIS Plug-in</title>
+    <title>Maven JDIff Plug-in</title>
     <author email="dion@apache.org">dIon Gillard</author>
   </properties>
 
@@ -29,7 +29,8 @@
       <subsection name="Overview of the Maven JDiff Plugin Documentation">       
       <p>
         This plugin is used to generate an API difference report between two
-        versions of code.
+        versions of code. See the <a href="http://www.jdiff.org/">JDiff home
+        page</a> for more information on JDiff.
       </p>
         <table>
           <tr><th>Document</th><th>Description</th></tr>         
diff --git a/jdiff/xdocs/properties.xml b/jdiff/xdocs/properties.xml
index b16aa1d3..5a747f90 100644
--- a/jdiff/xdocs/properties.xml
+++ b/jdiff/xdocs/properties.xml
@@ -35,19 +35,29 @@
           <td>maven.jdiff.old.tag</td>
           <td>Yes</td>
           <td>
-            <p>Default value is
-              <code>CURRENT</code>.</p>
+              The scm tag of the sources for the "old" API. The default value
+              <code>CURRENT</code>. When set to the default value, the files in
+              ${pom.build.sourceDirectory} are used as the "old" sources;
+              otherwise the scm plugin is used to check out the tag, using
+              ${pom.repository.connection}, the tag name and other <a href=
+              "http://maven.apache.org/reference/plugins/scm/properties.html">
+              scm plugin properties</a>.
           </td>
         </tr>
         <tr>
           <td>maven.jdiff.new.tag</td>
           <td>Yes</td>
           <td>
-            <p>Default value is
-              <code>HEAD</code>.</p>
+              The scm tag of the sources for the "new" API. The default value
+              <code>HEAD</code>. When set to "CURRENT", the files in
+              ${pom.build.sourceDirectory} are used as the "new" sources;
+              otherwise the scm plugin is used to check out the tag, using
+              ${pom.repository.connection}, the tag name and other <a href=
+              "http://maven.apache.org/reference/plugins/scm/properties.html">
+              scm plugin properties</a>.
           </td>
         </tr>
       </table>
     </section>
   </body>
-</document>
\ No newline at end of file
+</document>