Mailing-List: contact commits-help@subversion.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@subversion.apache.org
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1376992 -
 /subversion/trunk/subversion/libsvn_repos/repos.c
Date: Fri, 24 Aug 2012 17:02:25 -0000
To: commits@subversion.apache.org
From: cmpilato@apache.org
Message-Id: <20120824170225.44AA72388962@eris.apache.org>

Author: cmpilato
Date: Fri Aug 24 17:02:24 2012
New Revision: 1376992

URL: http://svn.apache.org/viewvc?rev=1376992&view=rev
Log:
* subversion/libsvn_repos/repos.c
  (create_hooks): Tweak 'start-commit' template text, grouping the
    description of the TXN-NAME arg closer to that of the CAPABILITIES arg.

Modified:
    subversion/trunk/subversion/libsvn_repos/repos.c

Modified: subversion/trunk/subversion/libsvn_repos/repos.c
URL: http://svn.apache.org/viewvc/subversion/trunk/subversion/libsvn_repos/repos.c?rev=1376992&r1=1376991&r2=1376992&view=diff
==============================================================================
--- subversion/trunk/subversion/libsvn_repos/repos.c (original)
+++ subversion/trunk/subversion/libsvn_repos/repos.c Fri Aug 24 17:02:24 2012
@@ -330,6 +330,11 @@ create_hooks(svn_repos_t *repos, apr_poo
 "# e.g.: \"" SVN_RA_CAPABILITY_MERGEINFO ":some-other-capability\" "         \
   "(the order is undefined)."                                                NL
 "#"                                                                          NL
+"# Note: The TXN-NAME parameter is new in Subversion 1.8.  Prior to version" NL
+"# 1.8, the start-commit hook was invoked before the commit txn was even"    NL
+"# created, so the ability to inspect the commit txn and its metadata from"  NL
+"# within the start-commit hook was not possible."                           NL
+"# "                                                                         NL
 "# The list is self-reported by the client.  Therefore, you should not"      NL
 "# make security assumptions based on the capabilities list, nor should"     NL
 "# you assume that clients reliably report every capability they have."      NL
@@ -353,10 +358,6 @@ create_hooks(svn_repos_t *repos, apr_poo
 "# '"SCRIPT_NAME".bat' or '"SCRIPT_NAME".exe',"                              NL
 "# but the basic idea is the same."                                          NL
 "# "                                                                         NL
-"# COMPATIBILITY NOTE:  Prior to Subversion 1.8, the start-commit hook was"  NL
-"# invoked before the commit txn was even created, and it did not accept"    NL
-"# the TXN-NAME argument at all."                                            NL
-"# "                                                                         NL
 HOOKS_ENVIRONMENT_TEXT
 "# "                                                                         NL
 "# Here is an example hook script, for a Unix /bin/sh interpreter."          NL