(Message Headers): Explain what

`message-alternative-emails' does in more detail.

diff --git a/texi/ChangeLog b/texi/ChangeLog
index 848bb7f..ce43fcc 100644 (file)
--- a/texi/ChangeLog
+++ b/texi/ChangeLog
@@ -1,5 +1,8 @@
 2005-09-11  Romain Francoise  <romain@orebokech.com>
 
+       * message.texi (Message Headers): Explain what
+       `message-alternative-emails' does in more detail.
+
        * gnus.texi (Mail Spool): Mention that `nnml-use-compressed-files'
        requires `auto-compression-mode' to be enabled.  Add new nnml
        variable `nnml-compressed-files-size-threshold'.

diff --git a/texi/message.texi b/texi/message.texi
index d707fbd..b382b96 100644 (file)
--- a/texi/message.texi
+++ b/texi/message.texi
@@ -1395,8 +1395,23 @@ trailing old subject.  In this case,
 
 @item message-alternative-emails
 @vindex message-alternative-emails
-A regexp to match the alternative email addresses.  The first matched
-address (not primary one) is used in the @code{From} field.
+Regexp matching alternative email addresses.  The first address in the
+To, Cc or From headers of the original article matching this variable is
+used as the From field of outgoing messages, replacing the default From
+value.
+
+For example, if you have two secondary email addresses john@@home.net
+and john.doe@@work.com and want to use them in the From field when
+composing a reply to a message addressed to one of them, you could set
+this variable like this:
+
+@lisp
+(setq message-alternative-emails
+      (regexp-opt '("john@@home.net" "john.doe@@work.com")))
+@end lisp
+
+This variable has precedence over posting styles and anything that runs
+off @code{message-setup-hook}.
 
 @item message-allow-no-recipients
 @vindex message-allow-no-recipients