Changes between Version 3 and Version 4 of TracTicketChangesetsPlugin
- Timestamp:
- Jun 4, 2010, 9:09:29 AM (14 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracTicketChangesetsPlugin
v3 v4 7 7 The TracTicketChangesetsPlugin hooks into changeset notifications and searches commit messages for ticket references. Referenced tickets are updated with the commit message, and all concerning changesets for a ticket are presented in a separate section on ticket pages, just above the change history section. 8 8 9 The macros `CommitMessage(repo, rev)` and `TicketChangesets(ticket)` are provided to present a commit message for a given repository and revision, and all changesets that are related to a given ticket.9 The source of this plugin is based on code provided distributed with Trac 0.12 (tracopt/ticket/commit_updater.py). The plugin works with multiple repositories. Language is translated if Babel is installed. 10 10 11 Console administration commands are available for resynchronizing relations between tickets and changesets. 12 13 The source of this plugin is based on code provided distributed with Trac 0.12 (tracopt/ticket/commit_updater.py). The plugin works with multiple repositories. 14 15 '''This plugin is not compatible with Trac 0.11''' 11 '''This plugin is not compatible with Trac 0.11 or older versions.''' 16 12 17 13 … … 37 33 [[Image(ticket_changesets_box.gif)]] 38 34 39 The plugin can be configured to present the box as initially collapsed, or hidden completely when no changesets are related to the ticket. Please see the in-built documentation for more details. Revision ranges can be presented in compact form, for example [420-422] instead of [420] [421] [422].35 When several repositories contains changesets relating to a ticket, the content will gracefully be split into one section for each repository. 40 36 37 The plugin can be configured to present the box as initially collapsed, or hidden completely when no changesets are related to the ticket. Revision ranges can be presented in compact form, for example [420-422] instead of [420] [421] [422]. 41 38 42 === Installation instructions === 39 The macros `CommitMessage(repo, rev)` and `TicketChangesets(ticket)` are provided to present a commit message for a given repository and revision, and all changesets that are related to a given ticket. 40 41 Console administration commands are available for resynchronizing relations between tickets and changesets: 42 * `trac-admin %ENV% ticket_changesets diff` 43 * `trac-admin %ENV% ticket_changesets reformat` (DANGEROUS!) 44 * `trac-admin %ENV% ticket_changesets resync` 45 46 Please see the in-built documentation for more details. 47 48 == Installation instructions == 43 49 1. Enable the plugin by the following in trac.ini: 44 50 {{{ … … 64 70 1. Re-synchronize repositories (optional, but recommended before next step which will scan all existing commit messages): 65 71 {{{ 66 trac-admin $ENV repository resync "*&"72 trac-admin %ENV% repository resync "*" 67 73 }}} 68 74 1. Build relations between tickets and changesets: 69 75 {{{ 70 trac-admin $ENVticket_changesets resync76 trac-admin %ENV% ticket_changesets resync 71 77 }}} 72 78 1. Re-format existing ticket commit messages (DANGEROUS!) 73 79 a. Produce a diff-like output for your analysis, which does not affect the database, before re-formatting existing commit messages: 74 80 {{{ 75 trac-admin $ENVticket_changesets diff > out.diff81 trac-admin %ENV% ticket_changesets diff > out.diff 76 82 }}} 77 83 Examine out.diff and assert that re-formatting is sensible before next step. 78 84 a. Re-format '''(DANGEROUS!)''' 79 85 {{{ 80 trac-admin $ENVticket_changesets reformat86 trac-admin %ENV% ticket_changesets reformat 81 87 }}} 82 88 1. Setup hook-scripts (Windows example, does not differ from official instructions applicable to Trac 0.12):