Merge branch 'stable-3.1'

* stable-3.1:
  Fix and clarify documentation of ref-update and commit-received hooks
  Correct documentation of ref-update hook regarding output

Change-Id: I0926e8a9ab58be09ba7c30b3834ddf86b483480f
diff --git a/src/main/resources/Documentation/ b/src/main/resources/Documentation/
index dad750f..16bbc46 100644
--- a/src/main/resources/Documentation/
+++ b/src/main/resources/Documentation/
@@ -60,6 +60,12 @@
 Called whenever a patchset is created (this includes new changes).
+New patchsets do not generate this event when created as a result of merging a change
+(see change-merged for this). Examples are:
+* Submitting a change
+* Merging a change
+* Closing a change by direct push to branch
   patchset-created --change <change id> --kind <change kind> --change-url <change url> --change-owner <change owner> --change-owner-username <username> --project <project name> --branch <branch> --topic <topic> --uploader <uploader> --uploader-username <username> --commit <sha1> --patchset <patchset id>