Reply-To: dev@subversion.apache.org Delivered-To: mailing list commits@subversion.apache.org Received: (qmail 89780 invoked by uid 99); 18 Sep 2012 10:15:32 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 18 Sep 2012 10:15:32 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 18 Sep 2012 10:15:28 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id CD05423889FA; Tue, 18 Sep 2012 10:14:40 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1387081 - /subversion/site/publish/docs/release-notes/1.8.html Date: Tue, 18 Sep 2012 10:14:40 -0000 To: commits@subversion.apache.org From: stsp@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20120918101440.CD05423889FA@eris.apache.org> Author: stsp Date: Tue Sep 18 10:14:40 2012 New Revision: 1387081 URL: http://svn.apache.org/viewvc?rev=1387081&view=rev Log: * publish/docs/release-notes/1.8.html: Mention hook script environment configuration support and UTF-8 support in mod_dav_svn. Modified: subversion/site/publish/docs/release-notes/1.8.html Modified: subversion/site/publish/docs/release-notes/1.8.html URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/release-notes/1.8.html?rev=1387081&r1=1387080&r2=1387081&view=diff ============================================================================== --- subversion/site/publish/docs/release-notes/1.8.html (original) +++ subversion/site/publish/docs/release-notes/1.8.html Tue Sep 18 10:14:40 2012 @@ -649,6 +649,41 @@ We will consider amending the list of sy href="http://svn.apache.org/repos/asf/subversion/trunk/CHANGES">CHANGES file for details.

`mod_dav_svn` now supports hook script UTF-8 input/output + ¶ +

+ +

As documented in issue #2487, hook scripts run on a mod_dav_svn-based +Subversion server previously had problems with non-ASCII input and output. +Because Apache HTTPD modules always run in the "C" locale, +which is restricted to ASCII, mod_dav_svn usually failed +trying to process non-ASCII characters.

+ +

Among other problems, this prevented pre-lock and +post-unlock hook scripts from operating on paths containing +non-ASCII characters, and prevented non-ASCII error output from +start-commit and pre-commit hooks from reaching +SVN clients.

+ +

Subversion 1.8 addresses these problems with a new SVNUseUTF8 +option for mod_dav_svn. If this option is set, mod_dav_svn +assumes that all hook script input/output is encoded in UTF-8. +This is always the case for paths passed to hook scripts, since Subversion +uses UTF-8 internally for all paths. If this option is set, hook scripts +must write error messages to stderr in UTF-8. Because ASCII is a +subset of UTF-8 existing hook scripts will continue to work unmodified.

+ +

For best results, hook scripts should use a UTF-8 locale if the +SVNUseUTF8 option is active. It is recommended to configure +a UTF-8 locale using the hook script environment configuration file.

+ +

+ @@ -672,6 +707,49 @@ file for a complete list.

title="Link to this section">¶ +

Hook script environment variables are now configurable + ¶ +

+ +

In Subversion 1.7 and earlier, hook scripts always run in an empty +environment. If environment variables are needed hook scripts had to +configure them manually. Subversion 1.8 supports configuration of hook +script environment variables, on a per-server or per-repository basis.

+ +

The hook script environment is configured in a new configuration file +located either at conf/hooks-env in a repository, or at a +server-wide location specified in svnserve.conf (using the +new hooks-env option) or httpd.conf (using the +new SVNHooksEnv option).

+ +

The hook script environment configurtion file uses a format similar +to that of other Subversion configuration files:

+### This file is an example hook script environment configuration file.
+### Hook scripts run in an empty environment by default.
+### As shown below each section defines environment variables for a
+### particular hook script. The [default] section defines environment
+### variables for all hook scripts, unless overridden by a hook-specific
+### section.
+
+### This example configures a UTF-8 locale for all hook scripts, so that 
+### special characters, such as umlauts, may be printed to stderr.
+### If UTF-8 is used with a mod_dav_svn server, the SVNUseUTF8 option must
+### also be set to 'yes' in httpd.conf.
+### With svnserve, the LANG environment variable of the svnserve process
+### must be set to the same value as given here.
+[default]
+# LANG = en_US.UTF-8
+
+### This sets the PATH environment variable for the pre-commit hook.
+# [pre-commit]
+# PATH = /usr/local/bin:/usr/bin:/usr/sbin
+

+ +

mod_dav_svn now supports hook script UTF-8 input/output + ¶ +

Hook script environment variables are now configurable + ¶ +

post-commit hook grows txn-name argument

`mod_dav_svn` now supports hook script UTF-8 input/output + ¶ +

`post-commit` hook grows `txn-name` argument