= SVN Trac Hooks =

If the Trac Hooks for SVN has been installed for the svn repository
coupled to this Trac instance, the Key Phrases documented below may
be used in SVN commit messages to cause automatic updates and annotations
of Trac issues.

== The trac-post-commit-hook ==

This script looks at the commit message associated with an SVN commit,
and based on the presence of a number of key phrases will add annotations
to tickets and also possibly change ticket status, for instance closing
it.

=== Key Phrases ===

The key phrases available are:
{{{
  Fix <ticket_spec>
  Fixes <ticket_spec>
  Fix for <ticket_spec>
  Close <ticket_spec>
  Closes <ticket_spec>
  
  Addresses <ticket_spec>
  References <ticket_spec>
  Relates to <ticket_spec>
  Related to <ticket_spec>
  See <ticket_spec>
}}}

=== Ticket specification ===

The specification of the ticket to act on may specify one or more
tickets, using any of the following forms:
{{{
  <ticket>
  <ticket>, <ticket>{, <ticket>}
  <ticket>, <ticket> and <ticket>
}}}
and variations thereof.

=== Ticket identification ===

The individual ticket specification
can take any of the following forms:
{{{
  #<number>
  ticket <number>
  ticket:<number>
  issue <number>
  issue:<number>
  bug <number>
  bug:<number>
}}}

=== Examples ===

{{{
  Clarify header normalization vs matching request headers (see #147)

  Resolve #27: fix definition of idempotent

  Note change for issue 157 (related to #157)

  Define http and https URI schemes: addresses #58, #128, #159

  Define http and https URI schemes: addresses #58, #128, #159;
  fixes #157: removed reference to RFC1900 use of IP addresses in URI.

  Resolve #140: rephrase note so that it becomes clear that the described ...
}}}

=== Script ===

The default script installed as trac-post-commit-hook is:
http://tools.ietf.org/tools/wg-pages/svn-hook-files/trac-post-commit-hook