forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rgard...@apache.org
Subject svn commit: r504598 - /forrest/trunk/site-author/content/xdocs/docs_0_80/locationmap.xml
Date Wed, 07 Feb 2007 15:47:52 GMT
Author: rgardler
Date: Wed Feb  7 07:47:51 2007
New Revision: 504598

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

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

Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/locationmap.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_80/locationmap.xml?view=diff&rev=504598&r1=504597&r2=504598
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/locationmap.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/locationmap.xml Wed Feb  7 07:47:51
2007
@@ -277,6 +277,24 @@
         <p>With the above match in the locationmap, a link which has <code>href="lm:rewriteDemo/index"</code>
         will be rewritten to an offsite address at <code>domain.org</code></p>
       </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>
   </body>



Mime
View raw message