From fc8ea6b68ce2ac460f0804e0b5363d623cf89856 Mon Sep 17 00:00:00 2001
From: "mkanat%bugzilla.org"
 <mkanat%bugzilla.org@18797224-902f-48f8-a5cc-f745e15eee43>
Date: Thu, 27 Jan 2011 10:50:24 +0000
Subject: [PATCH] Add diffs parameter to bugmail_recipients hook. r=mkanat.

git-svn-id: svn://10.0.0.236/trunk@261843 18797224-902f-48f8-a5cc-f745e15eee43
---
 mozilla/webtools/bugzilla/.bzrrev             |  2 +-
 mozilla/webtools/bugzilla/Bugzilla/BugMail.pm |  2 +-
 mozilla/webtools/bugzilla/Bugzilla/Hook.pm    | 11 ++++++++++-
 3 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/mozilla/webtools/bugzilla/.bzrrev b/mozilla/webtools/bugzilla/.bzrrev
index e6d6241e891..204ad41d498 100644
--- a/mozilla/webtools/bugzilla/.bzrrev
+++ b/mozilla/webtools/bugzilla/.bzrrev
@@ -1 +1 @@
-7677
\ No newline at end of file
+7678
\ No newline at end of file
diff --git a/mozilla/webtools/bugzilla/Bugzilla/BugMail.pm b/mozilla/webtools/bugzilla/Bugzilla/BugMail.pm
index 41b7a3cf1bd..9630ce0ede5 100644
--- a/mozilla/webtools/bugzilla/Bugzilla/BugMail.pm
+++ b/mozilla/webtools/bugzilla/Bugzilla/BugMail.pm
@@ -191,7 +191,7 @@ sub Send {
     
     Bugzilla::Hook::process('bugmail_recipients',
                             { bug => $bug, recipients => \%recipients,
-                              users => \%user_cache });
+                              users => \%user_cache, diffs => $diffs });
 
     # Find all those user-watching anyone on the current list, who is not
     # on it already themselves.
diff --git a/mozilla/webtools/bugzilla/Bugzilla/Hook.pm b/mozilla/webtools/bugzilla/Bugzilla/Hook.pm
index abedfde4a8e..de46f9a25cc 100644
--- a/mozilla/webtools/bugzilla/Bugzilla/Hook.pm
+++ b/mozilla/webtools/bugzilla/Bugzilla/Hook.pm
@@ -502,8 +502,17 @@ Every id in the incoming C<recipients> hash will have an object in here.
 (But if you add additional recipients to the C<recipients> hash, you are 
 B<not> required to add them to this hash.)
 
-=back
+=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
 
 =head2 bugmail_relationships