[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/man/smtpmail.texi
From: |
Simon Josefsson |
Subject: |
[Emacs-diffs] Changes to emacs/man/smtpmail.texi |
Date: |
Sun, 23 Feb 2003 11:44:44 -0500 |
Index: emacs/man/smtpmail.texi
diff -c emacs/man/smtpmail.texi:1.1 emacs/man/smtpmail.texi:1.2
*** emacs/man/smtpmail.texi:1.1 Sun Feb 23 07:09:45 2003
--- emacs/man/smtpmail.texi Sun Feb 23 11:44:44 2003
***************
*** 34,54 ****
@titlepage
@title{Emacs SMTP Library}
@subtitle{An Emacs package for sending mail via SMTP}
! @author{Simon Josefsson}
@end titlepage
@node Top
! @chapter Sending mail via SMTP
@cindex SMTP
! On the Internet, mail is sent from host to host using the simple
! mail transfer protocol (SMTP). When you read and write mail you are
! using a mail program that does not use SMTP --- it just reads mails
! from files. This is called a mail user agent (MUA). The mail
! transfer agent (MTA) is the program that accepts mails via SMTP and
! stores them in files. You also need a mail transfer agent when you
! send mails. Your mail program has to send its mail to a MTA that can
! pass it on using SMTP.
Emacs includes a package for sending your mail to a SMTP server and
have it take care of delivering it to the final destination, rather
--- 34,131 ----
@titlepage
@title{Emacs SMTP Library}
@subtitle{An Emacs package for sending mail via SMTP}
! @author{Simon Josefsson, Alex Schroeder}
! @page
! @vskip 0pt plus 1filll
! @insertcopying
@end titlepage
+ @contents
+
+ @ifnottex
@node Top
! @top Emacs SMTP Library
!
! @insertcopying
! @end ifnottex
!
! @menu
! * How Mail Works:: Brief introduction to mail concepts.
! * Emacs Speaks SMTP:: How to use the SMTP library in Emacs.
! * Authentication:: Authenticating yourself to the server.
! * Queued delivery:: Sending mail without an Internet connection.
! * Server workarounds:: Mail servers with special requirements.
! * Debugging:: Tracking down problems.
!
! Indices
!
! * Index:: Index over variables and functions.
! @end menu
!
! @node How Mail Works
! @chapter How Mail Works
!
@cindex SMTP
+ @cindex MTA
+ On the Internet, mail is sent from mail host to mail host using the
+ simple mail transfer protocol (SMTP). To send and receive mail, you
+ must get it from and send it to a mail host. Every mail host runs a
+ mail transger agent (MTA) such as Exim that accepts mails and passes
+ them on. The communication between a mail host and other clients does
+ not necessarily involve SMTP, however. Here is short overview of what
+ is involved.
+
+ @cindex MUA
+ The mail program --- also called a mail user agent (MUA) ---
+ usually sends outgoing mail to a mail host. When your computer is
+ permanently connected to the internet, it might even be a mail host
+ itself. In this case, the MUA will pipe mail to the
+ @file{/usr/lib/sendmail} application. It will take care of your mail
+ and pass it on to the next mail host.
+
+ @cindex ISP
+ When you are only connected to the internet from time to time, your
+ internet service provider (ISP) has probably told you which mail host
+ to use. You must configure your MUA to use that mail host. Since you
+ are reading this manual, you probably want to configure Emacs to use
+ SMTP to send mail to that mail host. More on that in the next
+ section.
+
+ @cindex MDA
+ Things are different when reading mail. The mail host responsible
+ for your mail keeps it in a file somewhere. The messages get into the
+ file by way of a mail delivery agent (MDA) such as procmail. These
+ delivery agents often allow you to filter and munge your mails before
+ you get to see it. When your computer is that mail host, this file is
+ called a spool, and sometimes located in the directory
+ /var/spool/mail/. All your MUA has to do is read mail from the spool,
+ then.
+
+ @cindex POP3
+ @cindex IMAP
+ When your computer is not always connected to the Internet, you
+ must get the mail from the remote mail host using a protocol such as
+ POP3 or IMAP. POP3 essentially downloads all your mail from the mail
+ host to your computer. The mail is stored in some file on your
+ computer, and again, all your MUA has to do is read mail from the
+ spool.
+
+ When you read mail from various machines, downloading mail from the
+ mail host to your current machine is not convenient. In that case,
+ you will probably want to use the IMAP protocol. Your mail is kept on
+ the mail host, and you can read it while you are connected via IMAP to
+ the mail host.
+
+ @cindex Webmail
+ So how does reading mail via the web work, you ask. In that case,
+ the web interface just allows you to remote-control a MUA on the web
+ host. Whether the web host is also a mail host, and how all the
+ pieces interact is completely irrelevant. You usually cannot use
+ Emacs to read mail via the web, unless you use software that parses
+ the ever-changing HTML of the web interface.
! @node Emacs Speaks SMTP
! @chapter Emacs Speaks SMTP
Emacs includes a package for sending your mail to a SMTP server and
have it take care of delivering it to the final destination, rather
***************
*** 126,142 ****
(setq smtpmail-smtp-service 587)
@end example
- @menu
- * Authentication:: Authenticating yourself to the server.
- * Queued delivery:: Sending mail without an Internet connection.
- * Server workarounds:: Mail servers with special requirements.
- * Debugging:: Tracking down problems.
- * Index:: Index over variables and functions.
- @end menu
-
@node Authentication
! @section Authentication
Many environments require SMTP clients to authenticate themselves
before they are allowed to route mail via a server. The two following
variables contains the authentication information needed for this.
--- 203,216 ----
(setq smtpmail-smtp-service 587)
@end example
@node Authentication
! @chapter Authentication
+ @cindex SASL
+ @cindex CRAM-MD5
+ @cindex PLAIN
+ @cindex LOGIN
+ @cindex STARTTLS
Many environments require SMTP clients to authenticate themselves
before they are allowed to route mail via a server. The two following
variables contains the authentication information needed for this.
***************
*** 198,205 ****
@end example
@node Queued delivery
! @section Queued delivery
If you connect to the Internet via a dialup connection, or for some
other reason doesn't have permanent Internet connection, sending mail
will fail when you are not connected. The SMTP library implements
--- 272,280 ----
@end example
@node Queued delivery
! @chapter Queued delivery
+ @cindex Dialup connection
If you connect to the Internet via a dialup connection, or for some
other reason doesn't have permanent Internet connection, sending mail
will fail when you are not connected. The SMTP library implements
***************
*** 233,239 ****
@node Server workarounds
! @section Server workarounds
Some SMTP servers have special requirements. The following variables
implement support for common requirements.
--- 308,314 ----
@node Server workarounds
! @chapter Server workarounds
Some SMTP servers have special requirements. The following variables
implement support for common requirements.
***************
*** 272,278 ****
@node Debugging
! @section Debugging
Sometimes delivery fails, often with the generic error message
@samp{Sending failed; SMTP protocol error}. Enabling one or both of
--- 347,353 ----
@node Debugging
! @chapter Debugging
Sometimes delivery fails, often with the generic error message
@samp{Sending failed; SMTP protocol error}. Enabling one or both of
***************
*** 302,308 ****
--- 377,390 ----
@end table
@node Index
+ @chapter Index
+
+ @section Concept Index
+
+ @printindex cp
+
@section Function and Variable Index
+
@printindex fn
@contents