From 56e6b49f06081737ea3816044075e2208046d387 Mon Sep 17 00:00:00 2001
From: jjensen <jjensen@13f79535-47bb-0310-9956-ffa450edef68>
Date: Sat, 21 Apr 2007 14:45:10 +0000
Subject: [PATCH] Create "alternate doclet settings" section, and move the
 existing 3 properties to it.

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@531042 13f79535-47bb-0310-9956-ffa450edef68
---
 javadoc/xdocs/properties.xml | 75 +++++++++++++++++++++---------------
 1 file changed, 44 insertions(+), 31 deletions(-)

diff --git a/javadoc/xdocs/properties.xml b/javadoc/xdocs/properties.xml
index e7dbd1a1..ee90217c 100644
--- a/javadoc/xdocs/properties.xml
+++ b/javadoc/xdocs/properties.xml
@@ -56,37 +56,6 @@
             The default value is <code>false</code>.
           </td>
         </tr>
-        <tr>
-          <td>maven.javadoc.doclet</td>
-          <td>Yes</td>
-          <td>
-            Specifies the doclet to use when calling javadoc. See
-            <a href="http://ant.apache.org/manual/CoreTasks/javadoc.html">the 
-            ant javadoc task</a> documentation for more detail.
-            See <a href="faq.html#classdiagrams">Class Diagrams FAQ</a>
-            as an example.
-          </td>
-        </tr>
-        <tr>
-          <td>maven.javadoc.docletpath</td>
-          <td>Yes</td>
-          <td>
-            Specifies the path to the doclet class when calling javadoc with a
-            custom doclet. See
-            <a href="http://ant.apache.org/manual/CoreTasks/javadoc.html">the 
-            ant javadoc task</a> documentation for more detail.
-          </td>
-        </tr>
-        <tr>
-          <td>maven.javadoc.usestandardparameters</td>
-          <td>Yes</td>
-          <td>
-            If this option is set, javadoc will use the standard doclet
-            parameters (see <a href="#Standard_Doclet_Settings">below</a>)
-            even if the <code>maven.javadoc.doclet</code> option is set.
-            This is useful for doclets that extend the standard one.
-          </td>
-        </tr>
         <tr>
           <td>maven.javadoc.excludepackagenames</td>
           <td>Yes</td>
@@ -368,6 +337,50 @@ tag2.scope=all]]></source>
         </tr>
       </table>
     </section>
+    <section name="Alternate Doclet Settings">
+      <table>
+        <tr>
+          <th>Type</th>
+          <th>Name</th>
+          <th>Optional?</th>
+          <th>Description</th>
+        </tr>
+        <tr>
+          <td>maven.javadoc.doclet</td>
+          <td>Yes</td>
+          <td>
+            Specifies the doclet to use when calling javadoc. See
+            <a href="http://ant.apache.org/manual/CoreTasks/javadoc.html">the 
+            ant javadoc task</a> documentation for more detail.
+            See <a href="faq.html#classdiagrams">Class Diagrams FAQ</a>
+            as an example.
+          </td>
+        </tr>
+        <tr>
+          <td>maven.javadoc.docletpath</td>
+          <td>Yes</td>
+          <td>
+            Specifies the path to the doclet class when calling javadoc with a
+            custom doclet. See
+            <a href="http://ant.apache.org/manual/CoreTasks/javadoc.html">the 
+            ant javadoc task</a> documentation for more detail.
+          </td>
+        </tr>
+        <tr>
+          <td>maven.javadoc.usestandardparameters</td>
+          <td>Yes</td>
+          <td>
+            If this option is set (to a any value), javadoc will use the standard doclet
+            parameters (see <a href="#Standard_Doclet_Settings">above</a>)
+            even if the <code>maven.javadoc.doclet</code> option is set.
+            This is useful for doclets that extend the standard one.
+            When specifying an alternate doclet,
+            the plugin does not use the standard doclet parameters
+            unless this property is set.
+          </td>
+        </tr>
+      </table>
+    </section>
     <section name="Other Settings">
       <table>
         <tr>