- 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

@@ -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>

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>

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"/>

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">