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>
