Return-Path: 
 <svn-return-6530-apmail-forrest-svn-archive=forrest.apache.org@forrest.apache.org>
Delivered-To: apmail-forrest-svn-archive@www.apache.org
Received: (qmail 641 invoked from network); 7 Feb 2007 15:48:13 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2)
  by minotaur.apache.org with SMTP; 7 Feb 2007 15:48:13 -0000
Received: (qmail 33546 invoked by uid 500); 7 Feb 2007 15:48:20 -0000
Delivered-To: apmail-forrest-svn-archive@forrest.apache.org
Received: (qmail 33519 invoked by uid 500); 7 Feb 2007 15:48:20 -0000
Mailing-List: contact svn-help@forrest.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:svn-help@forrest.apache.org>
list-unsubscribe: <mailto:svn-unsubscribe@forrest.apache.org>
List-Post: <mailto:svn@forrest.apache.org>
Reply-To: "Forrest Developers List" <dev@forrest.apache.org>
List-Id: <svn.forrest.apache.org>
Delivered-To: mailing list svn@forrest.apache.org
Received: (qmail 33508 invoked by uid 99); 7 Feb 2007 15:48:20 -0000
Received: from herse.apache.org (HELO herse.apache.org) (140.211.11.133)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 07 Feb 2007 07:48:20 -0800
X-ASF-Spam-Status: No, hits=-9.4 required=10.0
	tests=ALL_TRUSTED,NO_REAL_NAME
X-Spam-Check-By: apache.org
Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 07 Feb 2007 07:48:12 -0800
Received: by eris.apache.org (Postfix, from userid 65534)
	id 5E5C61A981A; Wed,  7 Feb 2007 07:47:52 -0800 (PST)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r504598 -
 /forrest/trunk/site-author/content/xdocs/docs_0_80/locationmap.xml
Date: Wed, 07 Feb 2007 15:47:52 -0000
To: svn@forrest.apache.org
From: rgardler@apache.org
X-Mailer: svnmailer-1.1.0
Message-Id: <20070207154752.5E5C61A981A@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org

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>