From be9219f24b9d81e94287ed35dffe0c69f4acb44c Mon Sep 17 00:00:00 2001
From: dion <dion@13f79535-47bb-0310-9956-ffa450edef68>
Date: Mon, 15 Mar 2004 11:09:09 +0000
Subject: [PATCH] - Document maven.ear.src property - Document
 maven.ear.resources property - Add FAQ on including resources in an EAR - Add
 FAQ to navigation - Add FAQ to project reports

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@114910 13f79535-47bb-0310-9956-ffa450edef68
---
 ear/project.xml          |  2 +-
 ear/xdocs/faq.fml        | 46 ++++++++++++++++++++++++++++++++++++++++
 ear/xdocs/navigation.xml |  1 +
 ear/xdocs/properties.xml | 24 +++++++++++++++++++--
 4 files changed, 70 insertions(+), 3 deletions(-)
 create mode 100644 ear/xdocs/faq.fml

diff --git a/ear/project.xml b/ear/project.xml
index c03cc3ad..a8d89281 100644
--- a/ear/project.xml
+++ b/ear/project.xml
@@ -98,7 +98,7 @@
     <report>maven-changelog-plugin</report>
     <report>maven-file-activity-plugin</report>
     <report>maven-developer-activity-plugin</report>
-    <report>maven-file-activity-plugin</report>
+    <report>maven-faq-plugin</report>
     <report>maven-license-plugin</report>
     <report>maven-linkcheck-plugin</report>
   </reports>
diff --git a/ear/xdocs/faq.fml b/ear/xdocs/faq.fml
new file mode 100644
index 00000000..ae7213c5
--- /dev/null
+++ b/ear/xdocs/faq.fml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- 
+/*
+ * 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="Resources">
+    <title>Resources</title>
+   
+    <faq id="IncludingResources">
+      <question>How do I include other files in my EAR?</question>
+      <answer>
+        <p>There are two ways to include other resources in the EAR file</p>
+        <ol>
+          <li>
+            Using the <a href="properties.html"><code>maven.ear.src</code></a>
+            property, you can specify an entire directory to include, or
+          </li>
+          <li>
+            Alternatively, you can use the 
+            <a href="http://maven.apache.org/reference/project-descriptor.html#resources">resources element</a>
+            of the <code>project.xml</code> to specify resource across various
+            directory, just as you would for a jar or war project.
+          </li>
+        </ol>
+      </answer>
+    </faq>
+
+  </part>
+  
+</faqs>
\ No newline at end of file
diff --git a/ear/xdocs/navigation.xml b/ear/xdocs/navigation.xml
index 9fcdddc6..92776bae 100644
--- a/ear/xdocs/navigation.xml
+++ b/ear/xdocs/navigation.xml
@@ -29,6 +29,7 @@
     <menu name="Overview">
       <item name="Goals" href="/goals.html"/>
       <item name="Properties" href="/properties.html"/>
+      <item name="FAQs" href="/faq.html"/>
     </menu>
     <menu name="Downloads">
       <item name="EAR Plugin 1.3" href="http://www.ibiblio.org/maven/maven/plugins/maven-ear-plugin-1.3.jar"/>
diff --git a/ear/xdocs/properties.xml b/ear/xdocs/properties.xml
index e4416e4b..a913aa52 100644
--- a/ear/xdocs/properties.xml
+++ b/ear/xdocs/properties.xml
@@ -35,7 +35,7 @@
             Location of the manifest file to be used within the ear file.
           </td>
           <td>
-            src/application/META-INF/MANIFEST.MF
+            ${maven.src.dir}/application/META-INF/MANIFEST.MF
           </td>
         </tr>
         <tr>
@@ -46,7 +46,7 @@
             to be used within the ear file.
           </td>
           <td>
-            src/application/META-INF/application.xml
+            ${maven.src.dir}/application/META-INF/application.xml
           </td>
         </tr>
         <tr>
@@ -81,6 +81,26 @@
             ${pom.id}
           </td>
         </tr>
+        <tr>
+          <td>maven.ear.resources</td>
+          <td>Yes</td>
+          <td>
+            Directory that resources are copied to during the build
+          </td>
+          <td>
+            ${maven.build.dir}/ear
+          </td>
+        </tr>
+        <tr>
+          <td>maven.ear.src</td>
+          <td>Yes</td>
+          <td>
+            Single directory for extra files to include in the EAR
+          </td>
+          <td>
+            ${maven.src.dir}/application
+          </td>
+        </tr>
       </table>
     </section>
     <section name="other settings">