From 4c58c8316ade28e57da679c4cf6cea380ad88355 Mon Sep 17 00:00:00 2001
From: brett <brett@13f79535-47bb-0310-9956-ffa450edef68>
Date: Sat, 12 Jun 2004 05:36:18 +0000
Subject: [PATCH] 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        | 44 +++++++++++++++++++++++++++++++++++++
 clover/xdocs/navigation.xml |  1 +
 clover/xdocs/properties.xml | 13 -----------
 3 files changed, 45 insertions(+), 13 deletions(-)
 create mode 100644 clover/xdocs/faq.fml

diff --git a/clover/xdocs/faq.fml b/clover/xdocs/faq.fml
new file mode 100644
index 00000000..1c18131d
--- /dev/null
+++ b/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>
diff --git a/clover/xdocs/navigation.xml b/clover/xdocs/navigation.xml
index 768e68a9..d0e6f275 100644
--- a/clover/xdocs/navigation.xml
+++ b/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>
 
diff --git a/clover/xdocs/properties.xml b/clover/xdocs/properties.xml
index 5c09b542..7858aa9e 100644
--- a/clover/xdocs/properties.xml
+++ b/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>