INTRODUCTION

v0.20.1 is a minor update on v0.20.0 to address the performance problems that some 
people were seeing with the introduction of the <nowiki>BerkeleyDB</nowiki> for storage of the corpus.  
v0.20.1 sets the <nowiki>BerkeleyDB</nowiki> cache size (i.e. the amount of the corpus that is kept 
in memory) to 64KB and it can be controlled through the bayes_db_cache_size 
parameter if needed.  The default should work for everyone, you can set this to a 
higher value to keep more of the database in memory at the cost of using more 
memory.

There are also a number of bug fixes in v0.20.1:

1. If you set a password and used X-POPFile-Link you were unable to get past
   the password screen when clicking on an XPL. (bug #831472)

2. In some instances when the connection between the POP3 proxy and the mail
   server was lost it was possible to get in a deadlock where POPFile was 
   waiting for a command from the client and the client was waiting for a 
   response from POPFile. (bug #829947)

3. It was not possible to add pseudowords (e.g. header:From) as ignored words,
   now it is. (bug #827785)

4. Magnets that included $ or @ could be incorrectly matched when the @ or $ 
   was followed by %%__%%. (bug #826765)

ESSENTIAL READING IF YOU ARE UPGRADING TO v0.20.1

1. BACK UP YOUR OLD INSTALLATION: POPFile makes this really easy, just copy
   the entire POPFile directory somewhere.  You can then safely install
   POPFile v0.20.1 on top of your current installation; I just think a back up
   is a sensible precaution.

2. IF YOU ARE RUNNING WINDOWS: Please read the section below I AM RUNNING
   WINDOWS AND NEED TO CHECK MULTIPLE EMAIL ACCOUNTS SIMULTANEOUSLY

3. ON WINDOWS POPFILE IS NOW AN EXE.  Windows users will now be able to see
   POPFile running in the Task Manager with an executable called popfileXX.exe
   where the XX is one of f, if, b, ib depending on configuration.  POPFile
   is started by running popfile.exe which chooses the appropriate popfileXX.exe

   This might cause your firewall to ask about giving popfileXX.exe permissions, 
   in addition if you had allowed Perl permissions in your firewall they are
   NO LONGER needed.

4. The installer will cause POPFile to run in the foreground if the database
   upgrade is required so that the upgrade process is evident to the user. 
   Once upgraded you can switch to background my going to the Configuration
   tab and changing "Run POPFile in a console window?" to No.

I AM RUNNING WINDOWS AND NEED TO CHECK MULTIPLE EMAIL ACCOUNTS SIMULTANEOUSLY

Because the time taken to start a new process on Windows is long under Perl
there is an optimization for Windows that is present by default: when a new
connection is made between your email program and POPFile, POPFile handles it
in the 'parent' process.  This means that the connect happens fast and mail
starts downloading very quickly, but is means that you can only downloaded
messages from one server at a time (up to 6 other connections will be queued
up and dealt with in the order they arrive) and the UI is unavaiable while
downloading email.

You can turn this behavior off (and get simultaneous UI/email access and as
many email connections as you like) by going to the Configuration panel in
the UI and making sure that "Allow concurrent POP3 connections:" is set to
Yes, or by specifying -pop3_force_fork 1 on the command line.

I AM USING THE CROSS PLATFORM VERSION

POPFile requires a number of Perl modules that are available from CPAN.  New
in v0.20.x are the need for the following:

 <nowiki>BerkeleyDB</nowiki>
 Text::Kakasi (if you want Japanese language support)
 Encode       (if you want Japanese language support)

I LIKE TO LIVE DANGEROUSLY

In a future version POPFile will add official support for message classification
through the SMTP and NNTP (Usenet news) protocols.  There are currently proxy
modules for these protocols that work with v0.20.1, but they have not been 
fully tested.  If you are interested in getting them get them here:

http://cvs.sourceforge.net/viewcvs.py/*checkout*/popfile/engine/Proxy/SMTP.pm?rev=1.22
http://cvs.sourceforge.net/viewcvs.py/*checkout*/popfile/engine/Proxy/NNTP.pm?rev=1.21

and place them in POPFile's Proxy/ directory.  

DOWNLOADING

You can obtain the latest releases of POPFile by visiting

    http://sourceforge.net/project/showfiles.php?group_id=63137

UPGRADING

Just install POPFile on top of the currently installed version.  But did you
read the ESSENTIAL READING above first.

INTERNATIONALIZATION

This minor update includes localization into Turkish.

DONATIONS

Thank you to everyone who has clicked the Donate! button and donated their
hard earned cash to me in support of POPFile.  Thank you also to the people
who have contributed patches, feature requests, bug reports and translations.

    http://sourceforge.net/forum/forum.php?forum_id=213876

CONCLUSION
        
Keep the ideas and bug reports coming.  If you are interested in knowing 
more about what's planned for future POPFile versions (or just learning
about POPFile's history) visit the POPFile Roadmap:

http://sourceforge.net/docman/display_doc.php?docid=17906&group_id=63137

John.