Cleanup for PL3.

svn path=/trunk/; revision=402

1 files changed, 25 insertions, 6 deletions

diff --git a/INSTALL b/INSTALL
index f90b09d3..c697c967 100644
--- a/INSTALL
+++ b/INSTALL
@@ -31,7 +31,12 @@ Next run
 	make
 
 This will compile fetchmail for your system.  Note that in order to
-build it, you'll need either flex at version 2.5.3 org greater, or lex.
+build it, you'll need either flex at version 2.5.3 or greater, or lex.
+
+If mxget.c fails to compile, your DNS-query support isn't compatible
+with BSD's and Linux's.  Manually undefine HAVE_GETHOSTBYNAME in
+config.h and rebuild.  You'll lose the multidrop-mailbox feature and
+Kerberos option, but nothing else.
 
 3. INSTALL
 
@@ -59,11 +64,12 @@ at version 3.0b6 or later, do this
 
 (cd ~; mv ~/.poprc ~/.fetchmailrc)
 
-in order to migrate.  Be aware that some of popclient's unnecessary 
+in order to migrate.  Be aware that some of popclient's unnecessary
 options have been removed (see the NOTES file for explanation).  You
-can't deliver to a local mail file anymore, and using an MDA for delivery
-is discouraged.  If you throw those options away, fetchmail will now forward
-your mail into your system's normal Internet-mail delivery path.
+can't deliver to a local mail file anymore or to standard output any
+more, and using an MDA for delivery is discouraged.  If you throw
+those options away, fetchmail will now forward your mail into your
+system's normal Internet-mail delivery path.
 
 If you use an MDA with popclient or an older version of fetchmail that
 requires %s in the MDA string in order to substitute in a local
@@ -71,6 +77,19 @@ delivery address, remove it.  One consequences of the internal changes
 to support multi-drop mailboxes is that local delivery addresses will
 be appended to the end of the command in the obvious way.
 
+Actually, using an MDA is now almost always the wrong thing; the MDA
+facility has been retained only for people who can't or won't run a
+sendmail-like SMTP listener on port 25. The default, SMTP forwarding
+to port 25, is better for at least two major reasons.  One: it feeds
+retrieved POP and IMAP mail into your system's normal delivery path
+along with local mail and normal Internet mail.  Two: because the port
+25 listener returns a positive acknowledge, fetchmail can be sure
+you're not going to lose mail to a disk-full or some other
+resource-exhaustion problem.
+
+If you used to use -mda "procmail -d <you>" or something similar, forward
+to port 25 and do "| procmail -d <you>" in your ~/.forward file.
+
 5. TEST
 
 I strongly recommend that your first fetchmail run use the -v and -k
@@ -82,7 +101,7 @@ This software is known to work with the qpop/popper series of
 freeware POP3 servers; also with the imapd servers that are
 distributed with Pine from the University of Washington.  Other
 POP3 servers have been known to give it indigestion.  Test carefully!
-If you have problems, switch to imap.
+If you have problems, try to switch to IMAP.
 
 If you're going to use multi-drop mailboxes, test with particular care.
 This code was very difficult to test and should be considered experimental.