# HG changeset patch
# User Martin Bornhold <martin@rhodecode.com>
# Date 2016-09-27 08:34:12
# Node ID e9660b32039da2ef44108a289f60a2c5c619321e
# Parent  caf5ea418435b52bd53a3e1d053d7d32a4e6f2e8

svn-support: Add a note about the 'Error converting entry in directory to UTF-8' error.

diff --git a/rhodecode/svn_support/templates/mod-dav-svn.conf.mako b/rhodecode/svn_support/templates/mod-dav-svn.conf.mako
--- a/rhodecode/svn_support/templates/mod-dav-svn.conf.mako
+++ b/rhodecode/svn_support/templates/mod-dav-svn.conf.mako
@@ -7,11 +7,10 @@
 # The mod_dav_svn module does not support subversion repositories which are
 # organized in subfolders. To support the repository groups of RhodeCode it is
 # required to provide a <Location> block for each group pointing to the
-# repository group sub folder.
-#
-# To ease the configuration RhodeCode auto generates this file whenever a
-# repository group is created/changed/deleted. Auto generation can be configured
-# in the ini file.
+# repository group sub folder. To ease the configuration RhodeCode auto
+# generates this file whenever a repository group is created/changed/deleted.
+# Auto generation can be configured in the ini file. Settings are prefixed with
+# ``svn.proxy``.
 #
 # To include this configuration into your apache config you can use the
 # `Include` directive. See the following example snippet of a virtual host how
@@ -24,6 +23,18 @@
 #         CustomLog ${'${APACHE_LOG_DIR}'}/access.log combined
 #         Include /path/to/generated/mod_dav_svn.conf
 #     </VirtualHost>
+#
+# Depending on the apache configuration you may encounter the following error if
+# you are using speecial characters in your repository or repository group
+# names.
+#
+#    ``Error converting entry in directory '/path/to/repo' to UTF-8``
+#
+# In this case you have to change the LANG environment variable in the apache
+# configuration. This setting is typically located at ``/etc/apache2/envvars``.
+# You have to change it to an UTF-8 value like ``export LANG="en_US.UTF-8"``.
+# After changing this a stop and start of Apache is required (using restart
+# doesn't work).
 
 
 <Location "${location_root|n}">