Added an example FML document to the documentation

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

faq/maven.xml

@@ -0,0 +1,10 @@
+<project default="plugin:install">
+
+  <postGoal name="xdoc:copy-resources">
+    <copy todir="${basedir}/target/docs">
+      <fileset dir="${basedir}/xdocs">
+        <include name="**/*.fml"/>
+      </fileset>
+    </copy>
+  </postGoal>
+</project>

faq/xdocs/faq.fml

@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<faqs title="Frequently Asked Questions">
+
+  <part id="general">
+    <title>General</title>
+   
+    <faq id="whats-foo">
+      <question>
+        What is Foo?
+      </question>
+      <answer>
+        <p>some markup goes here</p>
+        
+        <source>some source code</source>
+        
+        <p>some markup goes here</p>
+      </answer>
+    </faq>
+
+    <faq id="whats-bar">
+      <question>
+        What is Bar?
+      </question>
+      <answer>
+        <p>some markup goes here</p>
+      </answer>
+    </faq>
+  </part>
+  
+  <part id="install">
+    <title>Installation</title>
+   
+    <faq id="how-install">
+      <question>
+        How do I install Foo?
+      </question>
+      <answer>
+        <p>some markup goes here</p>
+      </answer>
+    </faq>
+  </part>  
+</faqs>

faq/xdocs/index.xml

@@ -10,6 +10,13 @@
     <section name="Maven FAQ Plug-in">
       <p>
 				This plugin generates xdoc documentation from an XML FAQ document.
+				This automates the creation of an index of questions with hypertext
+				links to the full question and answers.
+      </p>
+      <p>
+        The plugin uses by default a file called <code>xdocs/faq.fml</code>
+        to generate the FAQ entry. There is an example of the XML format 
+        <a href="faq.fml">here</a>.
       </p>
       <p>
         The properties that allow you to customize the execution