From: Bill Wohler <wohler@newt.com>
Date: Fri, 3 Mar 2006 20:02:10 +0000 (+0000)
Subject: (mh-send-letter, mh-insert-auto-fields): Sync docstrings with manual.
X-Git-Tag: emacs-pretest-22.0.90~3794
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=3fbc098da9e1e5257bb7bcb219cf05c8a406b52e;p=emacs.git

(mh-send-letter, mh-insert-auto-fields): Sync docstrings with manual.
---

diff --git a/lisp/mh-e/ChangeLog b/lisp/mh-e/ChangeLog
index ed8cc726ddb..61db56d47b2 100644
--- a/lisp/mh-e/ChangeLog
+++ b/lisp/mh-e/ChangeLog
@@ -1,3 +1,8 @@
+2006-03-03  Bill Wohler  <wohler@newt.com>
+
+	* mh-comp.el (mh-send-letter, mh-insert-auto-fields): Sync
+	docstrings with manual.
+
 2006-03-02  Bill Wohler  <wohler@newt.com>
 
 	* mh-folder.el (mh-tool-bar-init): Autoload.
diff --git a/lisp/mh-e/mh-comp.el b/lisp/mh-e/mh-comp.el
index 5d2730f4afa..0cedc83719c 100644
--- a/lisp/mh-e/mh-comp.el
+++ b/lisp/mh-e/mh-comp.el
@@ -230,6 +230,13 @@ The hook `mh-before-send-letter-hook' is run at the beginning of
 this command. For example, if you want to check your spelling in
 your message before sending, add the function `ispell-message'.
 
+Unless `mh-insert-auto-fields' had previously been called
+manually, the function `mh-insert-auto-fields' is called to
+insert fields based upon the recipients. If fields are added, you
+are given a chance to see and to confirm these fields before the
+message is actually sent. You can do away with this confirmation
+by turning off the option `mh-auto-fields-prompt-flag'.
+
 In case the MH \"send\" program is installed under a different name,
 use `mh-send-prog' to tell MH-E the name."
   (interactive "P")
@@ -979,14 +986,16 @@ sequence."
 (defun mh-insert-auto-fields (&optional non-interactive)
   "Insert custom fields if recipient is found in `mh-auto-fields-list'.
 
-Sets buffer-local `mh-insert-auto-fields-done-local' if header
-fields were added. If NON-INTERACTIVE is non-nil, perform actions
-quietly and only if `mh-insert-auto-fields-done-local' is nil.
-
-An `identity' entry is skipped if one was already entered
-manually.
+Once the header contains one or more recipients, you may run this
+command to insert these fields manually. However, if you use this
+command, the automatic insertion when the message is sent is
+disabled.
 
-Return t if fields added; otherwise return nil."
+In a program, set buffer-local `mh-insert-auto-fields-done-local'
+if header fields were added. If NON-INTERACTIVE is non-nil,
+perform actions quietly and only if
+`mh-insert-auto-fields-done-local' is nil. Return t if fields
+added; otherwise return nil."
   (interactive)
   (when (or (not non-interactive)
             (not mh-insert-auto-fields-done-local))