From d4d520b057354081359ac30aa07d22e209effda3 Mon Sep 17 00:00:00 2001
From: Jan Materne <jhm@apache.org>
Date: Tue, 7 Apr 2009 06:34:49 +0000
Subject: [PATCH] FAQ entry: How to precompile JSP

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@762638 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/faq.html | 16 ++++++++++++++++
 xdocs/faq.xml | 15 +++++++++++++++
 2 files changed, 31 insertions(+)

diff --git a/docs/faq.html b/docs/faq.html
index 405a06343..4529bd67e 100644
--- a/docs/faq.html
+++ b/docs/faq.html
@@ -243,6 +243,9 @@
             </ul>
                 <h4 class="toc">How do I ...</h4>
         <ul>
+                <li><a href="#precompile-jsps">
+  How to I precompile Java Server Pages (JSPs)?
+      </a></li>
                 <li><a href="#implement-os-specific-configuration">
   How do I realize os--specific configurations?
       </a></li>
@@ -841,6 +844,19 @@ $ ant -version
 Apache Ant version 1.6.2 compiled on July 16 2004
 </pre>
                                 <p class="faq">
+      <a name="precompile-jsps"></a>
+      How to I precompile Java Server Pages (JSPs)?
+    </p>
+                  <p>Ant has a built in optional task <a href="/manual/OptionalTasks/jspc.html">&lt;jspc&gt;</a>
+        which was intended for that. <b>But this task is deprecated.</b>
+        Here the alternative suggested by the manual:</p>
+                        <p><i>Instead of relying on container specific JSP-compilers we suggest deploying
+        the raw files (*.jsp) and use the container build-in functions: after deploying
+        run a test suite (e.g. with
+        <a href="http://jakarta.apache.org/cactus/">Cactus</a> or
+        <a href="http://httpunit.sourceforge.net/">HttpUnit</a>) against the deployed web
+        application. So you'll get then test result and the compiled JSPs.</i></p>
+                    <p class="faq">
       <a name="implement-os-specific-configuration"></a>
       How do I realize os--specific configurations?
     </p>
diff --git a/xdocs/faq.xml b/xdocs/faq.xml
index 33cf6b92f..55e1fe01a 100644
--- a/xdocs/faq.xml
+++ b/xdocs/faq.xml
@@ -324,6 +324,21 @@ Apache Ant version 1.6.2 compiled on July 16 2004
   </faqsection>
 
   <faqsection title="How do I ...">
+    <faq id="precompile-jsps">
+      <question>How to I precompile Java Server Pages (JSPs)?</question>
+      <answer>
+        <p>Ant has a built in optional task <a href="/manual/OptionalTasks/jspc.html">&lt;jspc&gt;</a>
+        which was intended for that. <b>But this task is deprecated.</b>
+        Here the alternative suggested by the manual:</p>
+        <p><i>Instead of relying on container specific JSP-compilers we suggest deploying
+        the raw files (*.jsp) and use the container build-in functions: after deploying
+        run a test suite (e.g. with
+        <a href="http://jakarta.apache.org/cactus/">Cactus</a> or
+        <a href="http://httpunit.sourceforge.net/">HttpUnit</a>) against the deployed web
+        application. So you'll get then test result and the compiled JSPs.</i></p>
+      </answer>
+    </faq>
+  
     <faq id="implement-os-specific-configuration">
       <question>How do I realize os--specific configurations?</question>
       <answer>