document how to override clover jar "cleanly"

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

clover/xdocs/faq.fml

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+/*
+ * Copyright 2001-2004 The Apache Software Foundation.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * 
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+ -->
+
+<faqs title="Frequently Asked Questions">
+
+  <part id="general">
+    <title>General</title>
+   
+    <faq id="licensed-clover">
+      <question>
+        How do I force a different clover jar to be used?
+      </question>
+      <answer>
+        <p>
+          If you have a licensed clover JAR, or you want to upgrade the version used by the plugin, you will
+          need to use a jar override to force the clover plugin to use the updated JAR.
+        </p>
+        <p>eg: To use a local copy of clover-1.2.4-registered.jar, add this to project.properties:</p>
+          <source>maven.jar.override=on
+maven.jar.clover=lib/clover-1.2.4-registered.jar</source>
+        <p>eg: To use version 1.2.5 from the repository, add this to project.properties:</p>
+          <source>maven.jar.override=on
+maven.jar.clover=1.2.5</source>
+      </answer>
+    </faq>
+
+  </part>  
+</faqs>

clover/xdocs/navigation.xml

@@ -30,6 +30,7 @@
     <menu name="Overview">
       <item name="Goals" href="/goals.html"/>
       <item name="Properties" href="/properties.html"/>
+      <item name="FAQ" href="/faq.html"/>
     </menu>
   </body>
 

clover/xdocs/properties.xml

@@ -56,19 +56,6 @@
             <code>false</code>
           </td>
         </tr>
-        <tr>
-          <td>maven.clover.jar</td>
-          <td>Yes</td>
-          <td>
-            Allows the user to override the Clover jar. This is especially 
-            useful as the Clover jars are license-signed for a specific 
-            project so you might want to use different jars for different 
-            projects.
-          </td>
-          <td>
-            Undefined
-          </td>
-        </tr>
         <tr>
           <td>maven.clover.report.html</td>
           <td>Yes</td>