(compose-mail): Doc fix.

diff --git a/lisp/simple.el b/lisp/simple.el
index d19f906c69fde493d5aa720ac7b9dbc2daba4619..c0c122fa406c7abc073c395ab62773a734e280a8 100644 (file)
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -2912,9 +2912,11 @@ SWITCH-FUNCTION, if non-nil, is a function to use to
 switch to and display the buffer used for mail composition.
 
 YANK-ACTION, if non-nil, is an action to perform, if and when necessary,
-to insert the text of the message being replied to.
-It has the form (FUNCTION . ARGS).  Performing the action is done
-by applying FUNCTION to ARGS.
+to insert the raw text of the message being replied to.
+It has the form (FUNCTION . ARGS).  The user agent will apply
+FUNCTION to ARGS, to insert the raw text of the original message.
+\(The user agent will also run `mail-citation-hook', *after* the
+original text has been inserted in this way.)
 
 SEND-ACTIONS is a list of actions to call when the message is sent.
 Each action has the form (FUNCTION . ARGS)."