New attribute fileSuffix for the tag doc:registerReport allow to use another extension than '.html' for a report link.

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@379963 13f79535-47bb-0310-9956-ffa450edef68

xdoc/xdocs/changes.xml

@@ -27,6 +27,7 @@
   </properties>
   <body>
     <release version="1.10-SNAPSHOT" date="in SVN">
+      <action dev="aheritier" type="add">New attribute fileSuffix for the tag doc:registerReport allow to use another extension than '.html' for a report link.</action>
       <action dev="ltheussl" type="add">Include instructions for ClearCase, Starteam and Perforce access in the scm-usage page.</action>
       <action dev="ltheussl" type="add" issue="MPXDOC-191">Include dependencies' scope in dependencies page.</action>
       <action dev="ltheussl" type="add" issue="MPXDOC-190">Include the new theme <code>maven-stylus.css</code>.</action>

xdoc/xdocs/tags.xml

@@ -44,7 +44,7 @@
           <tr>
             <td>name</td>
             <td>No</td>
-            <td>The name of the report to register.</td>
+            <td>The name of the report to register. Used for navigation items.</td>
           </tr>
           <tr>
             <td>pluginName</td>
@@ -58,8 +58,18 @@
           </tr>
           <tr>
             <td>link</td>
-            <td>No</td>
-            <td>The nav-bar link for this report.</td>
+            <td>Either the link or the externalLink attributes must be defined.</td>
+            <td>The nav-bar link for this report. This link must be relative to the root directory of the documentation and it musn't contain the file suffix ('.html' for example).</td>
+          </tr>
+          <tr>
+            <td>fileSuffix</td>
+            <td>Yes</td>
+            <td>the file suffix to add to the link. '.html' by default. Used only if the link attribute is defined.</td>
+          </tr>
+          <tr>
+            <td>externalLink</td>
+            <td>Either the link or the externalLink attributes must be defined.</td>
+            <td>The nav-bar link for this report. This is a full url link (http://somewhere...).</td>
           </tr>
           <tr>
             <td>target</td>