[Emacs-diffs] /srv/bzr/emacs/emacs-23 r99691: Expand discussion of mail setup.

[Chong Yidong]

------------------------------------------------------------
revno: 99691
committer: Chong Yidong <address@hidden>
branch nick: emacs-23
timestamp: Sun 2010-03-28 14:44:47 -0400
message:
  Expand discussion of mail setup.
  
  * sending.texi (Sending Mail): Note variables that may need customizing.
  (Mail Sending): Expand discussion of send-mail-function.
modified:
  doc/emacs/ChangeLog
  doc/emacs/sending.texi

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2010-03-28 03:41:34 +0000
+++ b/doc/emacs/ChangeLog       2010-03-28 18:44:47 +0000
@@ -1,5 +1,11 @@
 2010-03-28  Chong Yidong  <address@hidden>
 
+       * sending.texi (Sending Mail): Note variables that may need
+       customizing.
+       (Mail Sending): Expand discussion of send-mail-function.
+
+2010-03-28  Chong Yidong  <address@hidden>
+
        Document Message mode as the default mail mode.
 
        * sending.texi (Sending Mail): Copyedits.

=== modified file 'doc/emacs/sending.texi'
--- a/doc/emacs/sending.texi    2010-03-28 03:41:34 +0000
+++ b/doc/emacs/sending.texi    2010-03-28 18:44:47 +0000
@@ -56,6 +56,12 @@
 m} to make a new mail buffer, and work with each mail buffer
 independently.
 
+  Before using Emacs to send mail, you may need to customize the
+variable @code{send-mail-function} if your system is not set up to
+deliver mail directly via SMTP (@pxref{Mail Sending}).  In addition,
+you may need to customize @code{user-mail-address} if the system
+cannot receive mail via SMTP (@pxref{Mail Headers}).
+
 @menu
 * Format: Mail Format.       Format of a mail message.
 * Headers: Mail Headers.      Details of some standard mail header fields.
@@ -404,17 +410,33 @@
 @cindex Mailclient
 @vindex send-mail-function
   The variable @code{send-mail-function} controls how the default mail
-user agent sends mail.  It should be set to a function.  In most
-cases, the default is @code{sendmail-send-it}, which delivers mail
-using @command{sendmail} (or a @command{sendmail}-compatible program).
-On Mac OS X and MS-Windows, however, the default is normally
address@hidden, which passes the mail buffer on to the
-system's designated mail client (see @file{mailclient.el}).  To send
-mail through an SMTP server, set @code{send-mail-function} to
address@hidden and set up the Emacs SMTP library
-(@pxref{Top,,Emacs SMTP Library, smtpmail, Sending mail via SMTP}).
-Another option is @code{feedmail-send-it} (see the commentary section
-of the @file{feedmail.el} package).
+user agent sends mail.  Its value should be a function, which can be
+one of the following:
+
address@hidden @code
address@hidden sendmail-send-it
+Send mail using the system's default @command{sendmail} (or
address@hidden) program.  This is the default on Unix
+and GNU, and works provided the system is a valid @dfn{mail host}
+(that is, provided it can deliver mail via SMTP).
+
address@hidden mailclient-send-it
+Pass the mail buffer on to the system's designated mail client (see
address@hidden).  This is the default on Mac OS X and
+MS-Windows.
+
address@hidden smtpmail-send-it
+Send mail through an external mail host (e.g., your Internet service
+provider's SMTP server).  You will need to tell Emacs how to contact
+the SMTP server, by customizing the variables
address@hidden and @code{smtpmail-auth-credentials}.
address@hidden,,Emacs SMTP Library, smtpmail, Sending mail via SMTP}.
+
address@hidden feedmail-send-it
+This is similar to @code{sendmail-send-it}, but allows you to queue
+messages for later sending.  See the commentary section in the file
address@hidden for more information.
address@hidden table
 
 @node Header Editing
 @subsection Mail Header Editing