Pileus Git - ~andy/fetchmail/blob - README

   1 Popclient README
   2
   3         $Log: README,v $
   4         Revision 1.3  1996/06/27 19:22:31  esr
   5         Sent to ceharris.
   6
   7         Revision 1.2  1996/06/26 19:08:55  esr
   8         This is what I sent Harris.
   9
  10         Revision 1.1  1996/06/26 15:27:06  esr
  11         Initial revision
  12
  13         Revision 1.3  1995/09/07 22:40:58  ceharris
  14         Final 3.0b4 release
  15
  16         Revision 1.2  1995/08/09 01:22:47  ceharris
  17         Final preparation for 3.0b2 release.
  18
  19         Revision 1.1  1995/08/07 21:09:19  ceharris
  20         Final preparation for popclient 3.0b1 release
  21
  22 This is a BETA release of popclient version 3.  Little if any user support
  23 is provided for this version of popclient.  Consider this BETA version to
  24 be a "developer/tester" release only.
  25
  26 Release History
  27
  28 3.0b7:
  29
  30 Eric S. Raymond <esr@thyrsus.com> hacked on 3.0b6.  Here are his change notes:
  31
  32 CONFIGURATION AND BUILDING
  33
  34 * The autoconfigure script incorrectly assumed that all Linuxes use
  35   /usr/bin/deliver.  Under Linux it now checks for both /usr/bin/delivermail
  36   and /bin/mail.
  37
  38 * I added a distribution-maker production to Makefile.in.
  39
  40 OPTIONS AND COMMAND LINE
  41
  42 * I have removed the -p command-line option. Given that there's a .poprc
  43   facility there is no excuse for encouraging users to put plaintext passwords
  44   in scripts which might be readable.
  45
  46 * Calling popclient with no arguments now causes it to query or operate
  47   on every host in the .poprc file.
  48
  49 * I have made --version more useful by having it dump the computed
  50   connection options for each server specified.
  51
  52 * The user can now explicitly set an MDA (such as procmail) with the
  53   new option -m or -mda.  Various possible MDAs are listed on the man page.
  54
  55 POPRC FILE SYNTAX
  56
  57 * The .poprc lexer now supports "-enclosed strings which may contain
  58   whitespace.
  59
  60 * I added a --yydebug option to enable .poprc parser debugging at runtime
  61   if the parser was generated with --debug.  It's not documented.
  62
  63 * You may now have a `defaults' entry in .poprc which sets overrideable
  64   values for other entries.  See the man page for details.
  65
  66 * It is now possible to set keep, flush and fetchall in your .poprc file.
  67
  68 * Fixed incorrect numbering of source lines in .poprc parse error messages.
  69
  70 * The configure.in specification no longer uses the obsolete AC_TRY_COMPILE
  71   macro (it uses AC_TRY_LINK instead).
  72
  73 MAILBOX LOCKING
  74
  75 * I have added mandatory locking of mailbox files where supported.
  76   This will cover Linux systems, in particular.
  77
  78 * The default behavior is now to do lock-protected append on the user's
  79   system mailbox rather than using delivermail or some other MDA.
  80   (This is a performance hack.)
  81
  82 * The autoconfigure script now looks for standard mail locations.  The
  83   default mail delivery agent is used only if it can't find a mail spool
  84   directory in the standard places.
  85
  86 FUNCTIONAL ENHANCEMENTS
  87
  88 * When using POP3, message headers are edited so that replies won't foo up.
  89   Anything that looks like a mail ID local to the POP host gets @ and the
  90   pop servername attached to it before being appended to the user's
  91   mailbox or passed to an MDA.
  92
  93 * I have implemented daemon mode.
  94
  95 * I have added a lock check to ensure that there is only one popclient
  96   running per user, and a --quit option to kill the currently running
  97   one.
  98
  99 DOCUMENTATION
 100
 101 * All changes and feature additions have been tested in actual use and are
 102   documented on the man page.
 103
 104 * I have turned the comments in the sample.poprc into a new manual
 105   section documenting the .poprc format.
 106
 107 MISCELLANEOUS BUG FIXES
 108
 109 * I fixed some de-initialization bugs in pop2.c and pop3.c that led to
 110   fd leaks (these became painfully obvious when I tested daemon mode!).
 111
 112 * I've fixed the flaky parser error messages. They turned out to be due
 113   to a misdeclaration of yytext.
 114
 115 There's only one feature I haven't been able to add successfully.  I
 116 want a --logfile option that redirects the daemon-mode output to a
 117 given file, but the code (in daemon.c near 200) unaccountably doesn't
 118 work (so I haven't documented it yet).
 119
 120 3.0b5
 121 o       "From " header fix in pop2.c and pop3.c
 122 o       Surpress "..." output when --stdout option specified in pop3.c
 123
 124 3.0b4
 125 o       alloca fix.
 126 o       various diagnostic/informational message fixes.
 127
 128 3.0b3
 129 o       Support for retrieving only new messages from maildrop when
 130         using POP3.
 131 o       Support for retrieving only the first n lines of each message
 132         when using POP3.
 133 o       APOP authentication support.
 134 o       Buffered socket input.
 135
 136 3.0b2
 137         This is a "new features" release.
 138 o       support for .poprc file.
 139 o       GNU-style long options.
 140 o       fixed passwords appearing in 'ps' output
 141 o       support for multiple servers on one command line
 142
 143 3.0b1
 144         This is mostly a test of the autoconfigure integration.
 145 Among the functions performed by the new configure script, is
 146 the ability to detect known system types, configures the mail
 147 delivery agent (MDA) correctly.  This should permanently solve
 148 the problem of using something other than an MDA for mail
 149 delivery (which continues to plague Linux slackware 1.2.9).
 150 For this beta, please check the values of MDA_PATH and MDA_ARGS
 151 carefully.  They should match the values found in your
 152 sendmail.cf file on the line which begins with "Mlocal".
 153
 154         Other changes from popclient version 2.21:
 155
 156 o       no longer uses getpass() from the C library.  The
 157         internal getpassword() function allows the use of long
 158         passwords.
 159
 160 o       integrated GNU getopt() for long options.  Long option
 161         names will appear in a future beta.
 162
 163 o       Several compiler warnings fixed.
 164
 165 o       Fixed problems related to missing include files in
 166         Solaris port.