svn commit: r1023171 - in /forrest/trunk/site-author: content/xdocs/docs_0_90/faq.xml content/xdocs/site.xml status.xml

Author: crossley
Date: Sat Oct 16 04:02:00 2010
New Revision: 1023171

URL: http://svn.apache.org/viewvc?rev=1023171&view=rev
Log:
Added FAQ. On Java 6 fails validate-sitemap task. Missing the RELAX NG datatype library.

Modified:
    forrest/trunk/site-author/content/xdocs/docs_0_90/faq.xml
    forrest/trunk/site-author/content/xdocs/site.xml
    forrest/trunk/site-author/status.xml

Modified: forrest/trunk/site-author/content/xdocs/docs_0_90/faq.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_90/faq.xml?rev=1023171&r1=1023170&r2=1023171&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_90/faq.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_90/faq.xml Sat Oct 16 04:02:00 2010
@@ -183,6 +183,33 @@ forrest -Dproject.start-uri=live-sites.h
         </p>
       </answer>
     </faq>
+    <faq id="oldjing">
+      <question>On Java 6 fails validate-sitemap task. Missing the RELAX NG datatype library.</question>
+      <answer>
+        <source>
+<![CDATA[validate-sitemap:
+apache-forrest-0.8/main/webapp/resources/schema/relaxng/sitemap-v06.rng:72:31:
+error: datatype library "http://www.w3.org/2001/XMLSchema-datatypes" not recognized
+]]></source>
+        <p>
+          The version of Jing needs to be updated. 
+        </p>
+        <p>
+          This is fixed in Forrest-0.9-dev version.
+          See <link href="http://issues.apache.org/jira/browse/FOR-984">FOR-984</link>.
+        </p>
+        <p>
+          One workaround is to update your copy of the
+          <link href="http://code.google.com/p/jing-trang/">Jing</link> jar at
+          <code>$FORREST_HOME/lib/core/</code>
+        </p>
+        <p>
+          Another workaround is to edit the forrest.properties configuration file
+          to expose the "forrest.validate.sitemap" property and set it to "false".
+          Might need to do the same for the "forrest.validate.stylesheets" property.
+        </p>
+      </answer>
+    </faq>
     <faq id="winjava">
       <question>Windows gets confused about which Java version to use.</question>
       <answer>

Modified: forrest/trunk/site-author/content/xdocs/site.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/site.xml?rev=1023171&r1=1023170&r2=1023171&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/site.xml (original)
+++ forrest/trunk/site-author/content/xdocs/site.xml Sat Oct 16 04:02:00 2010
@@ -326,6 +326,7 @@
         <link_raw href="#link_raw"/>
         <linkmap href="#linkmap"/>
         <logs href="#logs"/>
+        <oldjing href="#oldjing"/>
         <pdf_images href="#pdf_images"/>
         <rawHTML href="#rawHTML"/>
         <run_port href="#run_port"/>

Modified: forrest/trunk/site-author/status.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/status.xml?rev=1023171&r1=1023170&r2=1023171&view=diff
==============================================================================
--- forrest/trunk/site-author/status.xml (original)
+++ forrest/trunk/site-author/status.xml Sat Oct 16 04:02:00 2010
@@ -154,6 +154,11 @@
         <link href="site:upgrading_09">upgrading to v0.9</link>
       </action>
 <!-- 2010-08 -->
+      <action context="docs" type="add" dev="DC" fixes-bug="FOR-984" importance="high">
+        Added an <link href="site:faq/oldjing">FAQ</link>
+        to try to explain that Forrest does not require Java 6.
+      </action>
+<!-- 2010-08 -->
       <action context="code" type="update" dev="TWW">
         Updated Ehcache to 2.2.0
       </action>