Changes between Version 17 and Version 18 of TracRepositoryAdmin

Timestamp:

Jun 21, 2011, 12:07:34 AM (13 years ago)

Author:

Remy Blank

Comment:

Changed instructions about hooks on Mercurial to take #10225 into account.

TracRepositoryAdmin

@@ -123 +123 @@
 }}}
 
-Git hooks can be used in the same way for explicit syncing of git repositories.  Try in `.git/hooks/post-commit`
+The Unix variants above assume that the user running the Subversion commit has write access to the Trac environment, which is the case in the standard configuration where both the repository and Trac are served by the web server. If you access the repository through another means, for example `svn+ssh://`, you may have to run `trac-admin` with different privileges, for example by using `sudo`.
+
+Note that calling `trac-admin` in your Subversion hooks can slow down the commit and log editing operations on the client side. You might want to use the [trac:source:trunk/contrib/trac-svn-hook contrib/trac-svn-hook] script which starts `trac-admin` in an asynchronous way. The script also comes with a number of safety checks and usage advices which should make it easier to set up and test your hooks. There's no equivalent `trac-svn-hook.bat` for Windows yet, but the script can be run by Cygwin's bash.
+
+See the [http://svnbook.red-bean.com/en/1.5/svn.reposadmin.create.html#svn.reposadmin.create.hooks section about hooks] in the Subversion book for more information. Other repository types will require different hook setups.
+
+Git hooks can be used in the same way for explicit syncing of git repositories. Add the following to `.git/hooks/post-commit`:
 {{{
 REV=$(git rev-parse HEAD)
@@ -129 +135 @@
 }}}
 
-For Mercurial, add the following entries to the `.hgrc` file of each repository accessed by Trac (replacing `<my-repository>` with the name of the repository in Trac):
-{{{
+For Mercurial, add the following entries to the `.hgrc` file of each repository accessed by Trac (if [trac:TracMercurial] is installed in a Trac plugins directory, download [source:plugins/0.13/mercurial-plugin/tracext/hg/hooks.py hooks.py] and place it somewhere accessible):
+{{{#!ini
 [hooks]
-commit = trac-admin /path/to/env changeset added <my-repository> $HG_NODE
-changegroup = hg log -r $HG_NODE: --template "{node} " | xargs trac-admin /path/to/env changeset added <my-repository>
+; If mercurial-plugin is installed globally
+commit = python:tracext.hg.hooks:add_changesets
+changegroup = python:tracext.hg.hooks:add_changesets
+
+; If mercurial-plugin is installed in a Trac plugins directory
+commit = python:/path/to/hooks.py:add_changesets
+changegroup = python:/path/to/hooks.py:add_changesets
+
+[trac]
+env = /path/to/env
+trac-admin = /path/to/trac-admin
 }}}
-
-The Unix variants above assume that the user running the Subversion commit has write access to the Trac environment, which is the case in the standard configuration where both the repository and Trac are served by the web server. If you access the repository through another means, for example `svn+ssh://`, you may have to run `trac-admin` with different privileges, for example by using `sudo`.
-
-Note that calling `trac-admin` in your Subversion hooks can slow down the commit and log editing operations on the client side. You might want to use the [trac:source:trunk/contrib/trac-svn-hook contrib/trac-svn-hook] script which starts `trac-admin` in an asynchronous way. The script also comes with a number of safety checks and usage advices which should make it easier to set up and test your hooks. There's no equivalent `trac-svn-hook.bat` for Windows yet, but the script can be run by Cygwin's bash.
-
-See the [http://svnbook.red-bean.com/en/1.5/svn.reposadmin.create.html#svn.reposadmin.create.hooks section about hooks] in the Subversion book for more information. Other repository types will require different hook setups. Please see the plugin documentation for specific instructions.
 
 === Per-request synchronization === #PerRequestSync