04/16/2000

This is epop3mail version 0.9.9.5.

This release contains some bug fixes and some new features.

IMPORTANT NOTE TO USERS OF PREVIOUS VERSIONS: item #4 below REQUIRES A
CHANGE TO THE FORMAT OF THE .uidl* file.  See below for how to modify
your .uidl files manually.

0)  Revised email address: lee.franklin@worldnet.att.net

1)  epop3mail should now call the proper password reading routine when
    used with emacs v 20.6

2)  if a POP3 error occurs during login (e.g., invalid password),
    passwords are automatically flushed.

3)  restart-biff no longer prompts you, but rather will simply start
    biffing with the last known biff-interval.

4)  epop3mail can now read passwords from .emacs files (if you are not
    concerned about security).  Please see the description in
    epop3mail.el on how to properly initialize passwords in this way.

5)  With epop3-manage-mailbox, you can now mark messages to be SKIPPED
    (with the 's' key) during subsequent retrievals in addition to
    marking messages for deletion from the POP3 server.

    There are a couple of situations skipping messages might be a handy.

    -   You're on a laptop and dialing into work on a slow line.  Rather
        than downloading all the long memos with attachments sent to you
        by clueless colleagues and which can wait until you get back to
        the office, you'd rather just pick up your emacs mailing list
        mail.  Now you can choose which mails to download BEFORE doing
        RMAIL and still have it reside on the POP3 server for later
        retrieval.

    -   You've accidentally deleted some mail and can't restore it.
        Fortunately it's still residing on the POP3 server.  Go into
        epop3-manage and mark it 'skipped'.  Then re-enter epop3-manage
        and mark it 'unskipped'.  You can then retrieve the mail again
        (epop3mail will think it was not previously gotten).

        Of course the second use above won't work if you don't leave
        your mail on the server at least sometimes, but if you don't
        leave mail on the server, why are you using epop3mail?

    I have personally found the second use VERY handy.  I sometimes will
    deliberately leave IMPORTANT mail on the POP3 server (marked as
    'skipped') until I have my local copy backed up.  Then I can relax
    and delete the mail from the POP3 server.


If you are using a prior version of epop3mail, you will need to
(slightly) modify your .uidl* file(s).  These files are where epop3mail
stores the information regarding which messages are still resident on
your POP3 server(s).

The previous format for each line in the .uidl files was:

    UID nchars date from subject

The revised format for each line in the .uidl files is now:

    UID skipped nchars date from subject

where skipped is either 0 or 1.


You should MAKE COPIES of your .uidl files and then add a '0' between
the first and second fields.

Sorry about that.

Oh yes, if you encounter bugs, please use

    epop3-submit-bug-report

Thanks.


===============================================
(v 0.9.8)

This release fixes some minor (but very annoying!) bugs in epop3mail and
epop3manage.

1) epop3mail will now correctly report the number of waiting messages when
you have multiple mailboxes.  biff used to have a bug wherein he only
reported the number of messages on the LAST mailbox queried.

2) epop3manage now has an 'X' command whereby you can delete messages and
immediately quit.  epop3manage also will not do biffs until it quits,
unlike the previous version, where it would biff after a delete.

Also, if a mailbox has no messages, epop3manage will no longer choke when
making a null message display.  That was *very* annoying!


For those who are upgrading from older versions of epop3mail, you may not
know about epop3manage.  The following are notes from the previous release
explaining epop3manage.

===============================================
(v 0.9.7)

The new thing is epop3manage.  You will need to add elib-1.0 to your
load-path, since epop3manage requires this library.

Also, there is a new interactive routine to pre-load passwords into the
password cache (good for users with multiple mailboxes -- all passwords
can be entered at the same time before biffing or getting the first mail).

If you're currently a users, the only changes you'll have to make to your
initializations are:


    (autoload 'stuff-pop-passwords "epop3mail" "pre-load passwords" t)
    (autoload 'epop3-manage-mailbox "epop3manage" "manage POP3 mailbox" t)


There have been a number of minor optimizations for epop3mail, no new
variables.

The main change to epop3mail is that more header data are stored in the
.uidl files.  This is to cache the from, date, subject etc to minimize
retrieval when later managing mail on the mailbox.

Also, if you only have one mailbox in your epop3-mailbox-list, epop3mail
is a bit smarter and doesn't constantly re-read your .uidl file over and
over again when getting mail.  There's no point in that unless you have
multiple mailboxes (which is not usually the case).




NEW CONFIGURATION VARIABLE:  epop3-manage-debug


I have set this to default to 't' in this test release.


NEW CONFIGURATION VARIABLE: epop3-manage-really-delete

I have set this to default to 'nil' in this test release.  To actually
have it delete things, you need to set this to 't'.


A brief explanation of epop3manage:

1) it will prompt you for the post office mailbox to manage.

Note: completions will be done for any "po:" entries in your
epop3-mailbox-list.  If there's only one such "po:" entry, then hitting
TAB will complete the prompt & you can press RET afterwards.


2) it requires that UIDL is supported by your pop3 server.  I could make
it do without but it is more efficient this way.


3) When you run epop3-manage, it will query the mailbox to get header
information which hasn't already been cached in the .uidl files.  It then
presents an rmail-like interface.


4) keystrokes in epop3-manage-mode:

You should look at the mode map in epop3-manage but here is a brief
summary -- it operates much like rmail-summary-mode:


move up & down the list using n, p, c-n, c-p, and arrows.

jump to a particular message with <prefix> j.

mark a message for deletion with d

unmark a message with u

actually do the deletions with x

You will be prompted to make sure.  Also, it shouldn't really delete if
epop3-manage-really-delete is set to nil.

To quit epop3-manage-mode, use q


5) you can only manage one mailbox at a time.


DON'T FORGET TO USE THE epop3-submit-bug-report function when reporting
problems.  This way a rather complete list of configuration variable
states will be included in the email with little effort on your part.

There is also an epop3-manage-submit-bug-report function as well.


Thanks...


- franklin <lee.franklin@worldnet.att.net>
