Show More
@@ -7,77 +7,69 b'' | |||
|
7 | 7 | |
|
8 | 8 | '''hooks for integrating with the Bugzilla bug tracker |
|
9 | 9 | |
|
10 | This hook extension adds comments on bugs in Bugzilla when changesets | |
|
11 |
|
|
|
12 | bug status. | |
|
10 | This hook extension adds comments on bugs in Bugzilla when changesets that | |
|
11 | refer to bugs by Bugzilla ID are seen. The hook does not change bug status. | |
|
13 | 12 | |
|
14 | The hook updates the Bugzilla database directly. Only Bugzilla | |
|
15 |
|
|
|
13 | The hook updates the Bugzilla database directly. Only Bugzilla installations | |
|
14 | using MySQL are supported. | |
|
16 | 15 | |
|
17 | The hook relies on a Bugzilla script to send bug change notification | |
|
18 |
|
|
|
19 |
|
|
|
20 |
|
|
|
21 | be run by Mercurial as the user pushing the change; you will need to | |
|
22 |
|
|
|
16 | The hook relies on a Bugzilla script to send bug change notification emails. | |
|
17 | That script changes between Bugzilla versions; the 'processmail' script used | |
|
18 | prior to 2.18 is replaced in 2.18 and subsequent versions by | |
|
19 | 'config/sendbugmail.pl'. Note that these will be run by Mercurial as the user | |
|
20 | pushing the change; you will need to ensure the Bugzilla install file | |
|
21 | permissions are set appropriately. | |
|
23 | 22 | |
|
24 | 23 | Configuring the extension: |
|
25 | 24 | |
|
26 | 25 | [bugzilla] |
|
27 | 26 | |
|
28 | host Hostname of the MySQL server holding the Bugzilla | |
|
29 | database. | |
|
27 | host Hostname of the MySQL server holding the Bugzilla database. | |
|
30 | 28 | db Name of the Bugzilla database in MySQL. Default 'bugs'. |
|
31 | 29 | user Username to use to access MySQL server. Default 'bugs'. |
|
32 | 30 | password Password to use to access MySQL server. |
|
33 | 31 | timeout Database connection timeout (seconds). Default 5. |
|
34 | version Bugzilla version. Specify '3.0' for Bugzilla versions | |
|
35 |
|
|
|
36 |
|
|
|
32 | version Bugzilla version. Specify '3.0' for Bugzilla versions 3.0 and | |
|
33 | later, '2.18' for Bugzilla versions from 2.18 and '2.16' for | |
|
34 | versions prior to 2.18. | |
|
37 | 35 | bzuser Fallback Bugzilla user name to record comments with, if |
|
38 | 36 | changeset committer cannot be found as a Bugzilla user. |
|
39 | bzdir Bugzilla install directory. Used by default notify. | |
|
40 |
|
|
|
37 | bzdir Bugzilla install directory. Used by default notify. Default | |
|
38 | '/var/www/html/bugzilla'. | |
|
41 | 39 | notify The command to run to get Bugzilla to send bug change |
|
42 | notification emails. Substitutes from a map with 3 | |
|
43 |
|
|
|
44 |
|
|
|
45 |
|
|
|
46 | %(id)s %(user)s". | |
|
40 | notification emails. Substitutes from a map with 3 keys, | |
|
41 | 'bzdir', 'id' (bug id) and 'user' (committer bugzilla email). | |
|
42 | Default depends on version; from 2.18 it is "cd %(bzdir)s && | |
|
43 | perl -T contrib/sendbugmail.pl %(id)s %(user)s". | |
|
47 | 44 | regexp Regular expression to match bug IDs in changeset commit |
|
48 | message. Must contain one "()" group. The default | |
|
49 |
|
|
|
50 |
|
|
|
51 |
|
|
|
45 | message. Must contain one "()" group. The default expression | |
|
46 | matches 'Bug 1234', 'Bug no. 1234', 'Bug number 1234', 'Bugs | |
|
47 | 1234,5678', 'Bug 1234 and 5678' and variations thereof. | |
|
48 | Matching is case insensitive. | |
|
52 | 49 | style The style file to use when formatting comments. |
|
53 | template Template to use when formatting comments. Overrides | |
|
54 |
s |
|
|
55 |
|
|
|
50 | template Template to use when formatting comments. Overrides style if | |
|
51 | specified. In addition to the usual Mercurial keywords, the | |
|
52 | extension specifies: | |
|
56 | 53 | {bug} The Bugzilla bug ID. |
|
57 | {root} The full pathname of the Mercurial | |
|
58 |
|
|
|
59 |
{ |
|
|
60 | repository. | |
|
61 | {hgweb} Base URL for browsing Mercurial | |
|
62 | repositories. | |
|
54 | {root} The full pathname of the Mercurial repository. | |
|
55 | {webroot} Stripped pathname of the Mercurial repository. | |
|
56 | {hgweb} Base URL for browsing Mercurial repositories. | |
|
63 | 57 | Default 'changeset {node|short} in repo {root} refers ' |
|
64 | 58 | 'to bug {bug}.\\ndetails:\\n\\t{desc|tabindent}' |
|
65 | strip The number of slashes to strip from the front of {root} | |
|
66 |
|
|
|
67 | usermap Path of file containing Mercurial committer ID to | |
|
68 |
|
|
|
69 | should contain one mapping per line, | |
|
70 | "committer"="Bugzilla user". See also the [usermap] | |
|
59 | strip The number of slashes to strip from the front of {root} to | |
|
60 | produce {webroot}. Default 0. | |
|
61 | usermap Path of file containing Mercurial committer ID to Bugzilla user | |
|
62 | ID mappings. If specified, the file should contain one mapping | |
|
63 | per line, "committer"="Bugzilla user". See also the [usermap] | |
|
71 | 64 | section. |
|
72 | 65 | |
|
73 | 66 | [usermap] |
|
74 | Any entries in this section specify mappings of Mercurial | |
|
75 |
|
|
|
76 | "committer"="Bugzilla user" | |
|
67 | Any entries in this section specify mappings of Mercurial committer ID to | |
|
68 | Bugzilla user ID. See also [bugzilla].usermap. "committer"="Bugzilla user" | |
|
77 | 69 | |
|
78 | 70 | [web] |
|
79 | baseurl Base URL for browsing Mercurial repositories. Reference | |
|
80 |
|
|
|
71 | baseurl Base URL for browsing Mercurial repositories. Reference from | |
|
72 | templates as {hgweb}. | |
|
81 | 73 | |
|
82 | 74 | Activating the extension: |
|
83 | 75 | |
@@ -90,9 +82,9 b' Activating the extension:' | |||
|
90 | 82 | |
|
91 | 83 | Example configuration: |
|
92 | 84 | |
|
93 | This example configuration is for a collection of Mercurial | |
|
94 |
|
|
|
95 |
|
|
|
85 | This example configuration is for a collection of Mercurial repositories in | |
|
86 | /var/local/hg/repos/ used with a local Bugzilla 3.2 installation in | |
|
87 | /opt/bugzilla-3.2. | |
|
96 | 88 | |
|
97 | 89 | [bugzilla] |
|
98 | 90 | host=localhost |
General Comments 0
You need to be logged in to leave comments.
Login now