[svnbook] r4326 committed - * en/book/ch09-reference.xml...

[svnbook at googlecode.com]

Revision: 4326
Author:   cmpilato at gmail.com
Date:     Wed Jan 16 11:10:58 2013
Log:      * en/book/ch09-reference.xml
   (svn.ref.mod_dav_svn.conf.directives): Document the new SVNUseUTF8
     directive.

Patch by: Neels J Hofmeyr <neels{__AT__}elego.de>
           (Tweaked by me.)


http://code.google.com/p/svnbook/source/detail?r=4326

Modified:
  /trunk/en/book/ch09-reference.xml

=======================================
--- /trunk/en/book/ch09-reference.xml	Tue Jan 15 16:26:34 2013
+++ /trunk/en/book/ch09-reference.xml	Wed Jan 16 11:10:58 2013
@@ -11302,6 +11302,40 @@
                  users will hunt you down with pitchforks and flaming
                  torches.</para>

+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><literal>SVNUseUTF8 On|Off</literal></term>
+            <listitem>
+
+              <para>When set to <literal>On</literal>,
+                <command>mod_dav_svn</command> will communicate with
+                hook scripts using repository root paths encoded in
+                UTF-8, and will expect those scripts to likewise
+                generate output (such as error messages) encoded in
+                UTF-8.  The default value of this option
+                is <literal>Off</literal>, which means
+                that <command>mod_dav_svn</command> assumes a 7-bit
+                ASCII encoding for its hook script interactions.  This
+                option is available as of Subversion 1.8.</para>
+
+              <note>
+                <para>Administrators should ensure that the character
+                  set and encoding expectations of hook scripts match
+                  all the ways they might be invoked.  For example, if
+                  one repository is served by both <command>httpd</command>
+                  and <command>svnserve</command>,  
<command>svnserve</command>
+                  should also be configured to use UTF-8 (by setting
+                  an appropriate locale in its environment) if this
+                  option is enabled for <command>mod_dav_svn</command>.
+                  Also, local filesystem paths containing non-ASCII
+                  characters which will be accessed by those scripts
+                  (such as repository root paths) must be properly
+                  encoded in the filesystem to match the scripts'
+                  expectations.</para>
+              </note>
+
              </listitem>
            </varlistentry>