svn commit: r504594 - /forrest/trunk/site-author/content/xdocs/docs_0_80/howto/howto-buildPlugin.xml

[rg...@apache.org]

Author: rgardler
Date: Wed Feb  7 07:42:24 2007
New Revision: 504594

URL: http://svn.apache.org/viewvc?view=rev&rev=504594
Log:
Add section on debugging

Modified:
    forrest/trunk/site-author/content/xdocs/docs_0_80/howto/howto-buildPlugin.xml

Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/howto/howto-buildPlugin.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_80/howto/howto-buildPlugin.xml?view=diff&rev=504594&r1=504593&r2=504594
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/howto/howto-buildPlugin.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/howto/howto-buildPlugin.xml Wed Feb  7 07:42:24 2007
@@ -408,6 +408,25 @@
         </ul>
       </section>
     </section>
+    
+    <section id="debugging">
+      <title>Debugging Locationmaps</title>
+      <p>Debugging the locationmap can be difficult because Cocoons error messages no
+      longer provide meaningful data. We hope to improve this over time, in the meantime
+      we recommend that you increase the log level of the locationmap logger. To do this
+      edit the following line in $FORREST_HOME/main/webapp/WEB-INF/logkit.conf:</p>
+      
+      <source><![CDATA[<category name="modules.mapper.lm" log-level="INFO">]]></source>
+      
+      <p>For example, you could change the log level to "DEBUG".</p>
+      
+      <p>Output from this logger can be found in 
+      $PROJECT_HOME/build/webapp/WEB-INF/logs/locationmap.log</p>
+      
+      <p>You shoul not run production systems with this logger set higher than "INFO
+      as each request can generate large amounts of log information.</p>
+    </section>
+    
       
     <section id="experimental">
       <title>Experimental Functionality</title>