how to render the FAQ.

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@269997 13f79535-47bb-0310-9956-ffa450edef68

docs/faq.html

@@ -106,6 +106,10 @@
   </a></li>
                     <li><a href="#adding-faqs">
   How can I contribute to this FAQ?
+  </a></li>
+                    <li><a href="#creating-faq">
+  How do you create the HTML version of this
+        FAQ?
   </a></li>
                 </ul>
       </blockquote>
@@ -324,6 +328,33 @@
                         </blockquote>
     </td></tr>
   </table>
+  </a>
+        <a name="creating-faq">
+  <table border="0" cellspacing="0" cellpadding="2" width="100%">
+    <tr><td bgcolor="#828DA6">
+      <font color="#ffffff" face="arial,helvetica,sanserif">
+        <strong>
+          How do you create the HTML version of this
+        FAQ?
+        </strong>
+      </font>
+    </td></tr>
+    <tr><td>
+      <blockquote>
+                              <p>We use 
+        <a href="http://jakarta.apache.org/velocity/anakia.html">Anakia</a>
+        to render the HTML version from the original XML file.</p>
+                                        <p>The Velocity stylesheets used to process the XML files can
+        be found in the <code>xdocs/stylesheets</code> subdirectory of
+        Ant's CVS repository - the build file <code>docs.xml</code> is
+        used to drive Anakia.  This file assumes that you have the
+        <code>jakarta-site2</code> module checked out from CVS as
+        well, but if you follow the instruction from Anakia's
+        homepage, you should get it to work without that.  Just make
+        sure all required jars are in the task's classpath.</p>
+                        </blockquote>
+    </td></tr>
+  </table>
   </a>
                         <a name="what-is-ant">
   <table border="0" cellspacing="0" cellpadding="2" width="100%">

xdocs/faq.xml

@@ -30,6 +30,27 @@
           page</a>.</p>
       </answer>
     </faq>
+
+    <faq id="creating-faq">
+      <question>How do you create the HTML version of this
+        FAQ?</question>
+
+      <answer>
+        <p>We use 
+        <a href="http://jakarta.apache.org/velocity/anakia.html">Anakia</a>
+        to render the HTML version from the original XML file.</p>
+
+        <p>The Velocity stylesheets used to process the XML files can
+        be found in the <code>xdocs/stylesheets</code> subdirectory of
+        Ant's CVS repository - the build file <code>docs.xml</code> is
+        used to drive Anakia.  This file assumes that you have the
+        <code>jakarta-site2</code> module checked out from CVS as
+        well, but if you follow the instruction from Anakia's
+        homepage, you should get it to work without that.  Just make
+        sure all required jars are in the task's classpath.</p>
+      </answer>
+    </faq>
+
   </faqsection>
 
   <faqsection title="General">