Add diffs parameter to bugmail_recipients hook. r=mkanat.

https://bugzilla.mozilla.org/show_bug.cgi?id=616422

diff --git a/Bugzilla/BugMail.pm b/Bugzilla/BugMail.pm
index 78a3970d67566daf4e6d944aa577f1d2d2461b3a..d12836273e2f871536c4d42139edc77d1763855f 100644 (file)
--- a/Bugzilla/BugMail.pm
+++ b/Bugzilla/BugMail.pm
@@ -343,7 +343,8 @@ sub Send {
     }
 
     Bugzilla::Hook::process('bugmail_recipients',
-                            { bug => $bug, recipients => \%recipients });
+                            { bug => $bug, recipients => \%recipients,
+                              diffs => $diffs });
 
     # Find all those user-watching anyone on the current list, who is not
     # on it already themselves.

diff --git a/Bugzilla/Hook.pm b/Bugzilla/Hook.pm
index f6fff241a56a43078792c4ebfcd4eea38a5b7806..a08e160a89e0c57a37a08fcfb4364fce619e1c7f 100644 (file)
--- a/Bugzilla/Hook.pm
+++ b/Bugzilla/Hook.pm
@@ -494,6 +494,16 @@ as though he were on the CC list:
 (We use C<+> in front of C<REL_CC> so that Perl interprets it as a constant
 instead of as a string.)
 
+=item C<diffs>
+
+This is a list of hashes, each hash representing a change to the bug. Each 
+hash has the following members: C<field_name>, C<bug_when>, C<old>, C<new> 
+and C<who> (a L<Bugzilla::User>). If appropriate, there will also be 
+C<attach_id> or C<comment_id>; if either is present, there will be 
+C<isprivate>. See C<_get_diffs> in F<Bugzilla/BugMail.pm> to see exactly how 
+it is populated. Warning: the format and existence of the "diffs" parameter 
+is subject to change in future releases of Bugzilla.
+
 =back