Edgewall Software
Home
Trac
Trac Hacks
Genshi
Babel
Bitten
Home
Download
Documentation
Mailing Lists
License
FAQ
Search:
Login
Preferences
Help/Guide
About Trac
Wiki
Timeline
Roadmap
Browse Source
View Tickets
New Ticket
Search
Context Navigation
+0
Start Page
Index
History
Editing CommitTicketUpdater
Adjust edit area height:
8
12
16
20
24
28
32
36
40
Edit side-by-side
= Commit Ticket Updater = === Description === The Commit Ticket Updater is an **optional component** which makes Trac react on keywords and ticket references found in commit log message. Referenced tickets get a new comment linking to the changeset and depending on the presence of appropriate keywords (like //closed//, //fixed//, //reopened//, etc.) the ticket status will be updated. === Hooks === That role was fulfilled by the [source:branches/0.11-stable/trac-post-commit-hook trac-post-commit-hook] for Subversion and previous versions of Trac (up to 0.11), but starting with Trac 0.12 and [TracRepositoryAdmin multiple repository support], a more general notification solution has been adopted. The post-commit hooks now should simply use `trac-admin` to notify the TracEnvironment that a changeset has been //[[span(title=trac-admin <env> changeset added <repos> <rev>,added)]]// or //[[span(title=trac-admin <env> changeset added <repos> <rev>,modified)]]//. See TracRepositoryAdmin#ExplicitSync for more details. This works for any kind of VersionControlSystem supported by Trac and can notify that information to any kind of listener, not only the commit ticket updater (see [[TracDev/ApiChanges/0.12#IRepositoryChangeListener]]). === Location === The `CommitTicketUpdater` component lives in `source:trunk/tracopt/ticket/commit_updater.py` and is maintained alongside the Trac core. It's included with every Trac installation as a plugin, but is not enabled by default because it's rooted in the `tracopt.` packages and not in `trac.`. Therefore it needs to be explicitly activated (e.g. trough the Admin interface). === Syntax === The basic syntax is of the form `[command] [ticketreference]`. A colon between the command and the ticket reference is allowed. The ticketreference also allows to list //multiple// ticket numbers separated by spaces and/or comma. You can use the following commands: * To **close** a ticket: //close//, //closed//, //closes//, //fix//, //fixed//, //fixes// * To **reference** a ticket: //addresses//, //re//, //references//, //refs//, //see// You can optionally refer to tickets with the following words * //ticket//, //issue//, //bug// Examples: * `close #10` * `closed: #10` * `closes ticket #10` * `fixes #10` * `fixes bug: #10` * `see #5` * `references #5, #6` * `fixes #10 #11`
Note:
See
WikiFormatting
and
TracWiki
for help on editing wiki content.
Change information
Your email or username:
E-mail address and name can be saved in the
Preferences
Comment about this change (optional):
Note:
See
TracWiki
for help on using the wiki.