From efba97d1d2568d4a71c39ec049cb1a5015855f75 Mon Sep 17 00:00:00 2001
From: James Moger <james.moger@gitblit.com>
Date: Wed, 30 Nov 2011 17:21:30 -0500
Subject: [PATCH] Clarified Tomcat forward-slash encoding in documentation (issue 29)

---
 distrib/gitblit.properties |    1 +
 docs/03_faq.mkd            |    3 ++-
 2 files changed, 3 insertions(+), 1 deletions(-)

diff --git a/distrib/gitblit.properties b/distrib/gitblit.properties
index 7ce4ddf..34361ef 100644
--- a/distrib/gitblit.properties
+++ b/distrib/gitblit.properties
@@ -202,6 +202,7 @@
 #
 # <https://issues.apache.org/jira/browse/WICKET-1303>
 # <http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10>
+# Add *org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true* to *CATALINA_OPTS*
 #
 # SINCE 0.5.2
 web.forwardSlashCharacter = /
diff --git a/docs/03_faq.mkd b/docs/03_faq.mkd
index 3e99fb7..478e199 100644
--- a/docs/03_faq.mkd
+++ b/docs/03_faq.mkd
@@ -66,7 +66,8 @@
 Tomcat takes the extra precaution of [disallowing embedded slashes by default](http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10).  This breaks Gitblit urls.  
 You have a few options on how to handle this scenario:
 
-1. [Tweak Tomcat](http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10) 
+1. [Tweak Tomcat](http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10)  
+Add *org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true* to *CATALINA_OPTS*
 2. *web.mountParameters = false* and use non-pretty, parameterized urls
 3. *web.forwardSlashCharacter = !* which tells Gitblit to use **!** instead of **/**
 

--
Gitblit v1.9.1