2 files changed, 4 insertions, 1 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index ffc894747bd..fe15ce23a1c 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -3,6 +3,7 @@
         * mail/sendmail.el (mail-interactive): Doc fix.
         (mail-yank-ignored-headers): Add X-RMAIL- headers, bump :version.
         (mail-setup): Use the function mail-signature.
+        (mail-mode-hook): Doc fix.
         (mail-to, mail-subject, mail-cc, mail-bcc, mail-reply-to)
         (mail-mail-reply-to, mail-mail-followup-to): Doc fixes.
         (mail-signature): Check the signature file is readable.
diff --git a/lisp/mail/sendmail.el b/lisp/mail/sendmail.el
index 7245a35f8f1..bbf42e16b1b 100644
--- a/lisp/mail/sendmail.el
+++ b/lisp/mail/sendmail.el
@@ -614,7 +614,9 @@ actually occur.")
   (run-hooks 'mail-setup-hook))
 
 (defcustom mail-mode-hook nil
-  "Hook run by Mail mode."
+  "Hook run by Mail mode.
+When composing a mail, this runs immediately after creating, or
+switching to, the `*mail*' buffer.  See also `mail-setup-hook'."
   :group 'sendmail
   :type 'hook
   :options '(footnote-mode))