[PATCH] Add description for SVNUseUTF8 (issue #2487)

[Daniel Shahaf]

Neels J Hofmeyr wrote on Thu, Feb 02, 2012 at 17:51:01 +0100:
> Got no commit access to the book -- and would appreciate a little review, too.
> 
> Context:
> http://subversion.tigris.org/issues/show_bug.cgi?id=2487
> http://svn.apache.org/viewvc?view=revision&revision=1239203
> 
> ~Neels
> 

> * en/book/ch09-reference.xml: Add description of SVNUseUTF8 for mod_dav_svn.
> 
> Index: en/book/ch09-reference.xml
> ===================================================================
> --- en/book/ch09-reference.xml	(revision 4248)
> +++ en/book/ch09-reference.xml	(working copy)
> @@ -11235,6 +11235,32 @@
>              </listitem>
>            </varlistentry>
>  
> +          <varlistentry>
> +            <term><literal>SVNUseUTF8 On|Off</literal></term>
> +            <listitem>
> +
> +              <para>When set to <literal>On</literal>, UTF-8 will be
> +                used as the native character set for all Subversion access.
> +                <command>httpd</command>'s native character set is usually
> +                limited to 7-bit ASCII, causing breakage when there are
> +                any special characters in repository root paths, arguments

s/special/non-ASCII/

> +                passed to hook scripts or error messages printed by hook
> +                scripts.  If you enable this option,
> +                <command>httpd</command>'s locale settings are ignored, and
> +                UTF-8 is used for all repository access as well as hook
> +                script communication, so that using UTF-8 characters
> +                becomes possible. Note that your hook scripts must then
> +                operate in the UTF-8 character set regardless of the

How are scripts supposed to know this?  Shouldn't we communicate to them
the expectations of them (via argv or env)?

> +                environment.  For example, if one repository is served both
> +                by <command>httpd</command> and
> +                <command>svnserve</command>, <command>svnserve</command>
> +                should also be configured to use UTF-8.  The default
> +                setting is <literal>Off</literal>. This option is available
> +                as of Subversion 1.8.</para>
> +
> +            </listitem>
> +          </varlistentry>
> +
>          </variablelist>
>        </refsect1>
>      </refentry>
> 




> _______________________________________________
> svnbook-dev mailing list
> svnbook-dev at red-bean.com
> http://www.red-bean.com/mailman/listinfo/svnbook-dev