Welcome to POPFile v1.0.1

POPFile is an email classification tool with a Naive Bayes classifier, POP3,
SMTP, NNTP proxies and IMAP filter and a web interface. It runs on most
platforms and with most email clients.

This version is a bug fix and minor feature release. It's also the first
release to have been built by Brian Smith.

WHAT'S CHANGED SINCE v1.0.0

1. Bug fixes

When POPFile starts up it no longer complains about a missing IMAP file if
IMAP has not been installed.

Fixed a bug in the IMAP module that allowed for unintentional reclassification
to the unclassified bucket.

Fixed a bug that causes segmentation faults when displaying messages which
have very long To, Cc or From headers in the POPFile UI.

Fixed a bug that causes a few warnings during the corpus upgrade process.

Add code to check for unexpected NULL characters in email messages (to avoid
SQLite problems).

2. POPFile improvements

POPFile's Brazilian Portuguese language file has been renamed. The new name
does not include any spaces.

The simplified and traditional Chinese language translations have been
updated.

POPFile's log file now includes entries showing when POPFile starts up and
shuts down. This makes it easier to read the log file.

The startup messages in the log file have been made easier to read by
splitting the long entries into shorter lines.

The IMAP module now issues a log message when it fails to connect to the
server.

Deletion of messages from the message history has been made faster.

3. Installer improvements

When upgrading an existing installation the installer now recommends
upgrading the existing SSL support files.

The installer and all of the NSIS-based programs have been built using the
latest NSIS compiler and newer versions of the plugins used to download files
from the internet. These NSIS-related improvements should reduce the number of
false alarms from various anti-virus packages.

The latest version of the SQLite command-line utility is now included.

4. UI improvements

The links to the wiki have been improved.

5. Other changes

The (outdated) manual is no longer included in the download. All documentation
for POPFile is online and can be found at http://getpopfile.org/docs/

WHERE TO DOWNLOAD

    http://getpopfile.org/download/

GETTING STARTED WITH POPFILE

An introduction to installing and using POPFile can be found in the
QuickStart guide:

  http://getpopfile.org/docs/QuickStart

SSL SUPPORT IN WINDOWS

SSL Support is offered as one of the optional components by the installer. If
the SSL Support option is selected the installer will download the necessary
files during installation.

If SSL support is not selected when installing (or upgrading) POPFile or if
the installer was unable to download all of the SSL files then POPFile's
"Add/Remove Programs" entry can be used to add SSL support to an existing
installation.

I AM USING THE CROSS PLATFORM VERSION

POPFile requires a number of Perl modules that are available from CPAN. You
will need:

 Date::Parse
 HTML::Template
 HTML::Tagset
 DBD::SQLite2
 DBI
 TimeDate

You can install all the required POPFile modules by getting the
Bundle::POPFile bundle from CPAN.

Please refer to the installation instructions on the POPFile wiki:

 http://getpopfile.org/docs/HowTos:CrossPlatformInstall

Japanese users may need to install some extra programs and Perl modules,
depending upon which Nihongo parser (wakachi-gaki program) they wish to use.
For more information about how to install them, see the POPFile wiki:

 http://getpopfile.org/docs/JP:HowTos:CrossPlatformInstall

CROSS PLATFORM VERSION KNOWN ISSUES

The current version of SQLite (v3.x) is not compatible with POPFile. You must
use DBD:SQLite2 to access the database.

Users of SSL on non-Windows platforms should NOT use IO::Socket::SSL v0.97 or
v0.99. They are known to be incompatible with POPFile; v1.13 is the most
recent release of IO::Socket::SSL that works correctly.

WINDOWS KNOWN ISSUES

1. THE TRAYICON ON WINDOWS CAN CAUSE POPFILE TO FREEZE.

With certain setups, if you attempt to view the trayicon's tooltip or hover
your cursor over it while checking or downloading mail POPFile may freeze. The
exact cause is still unknown but it may be related to some video drivers. If
this problem affects you turn off the trayicon.

Due to this issue, we suggest users of the IMAP module disable the trayicon
since a freeze may go unnoticed more easily than when using a mail client to
make POP3 connections.

2. ON WINDOWS I WANT 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 the connect happens fast and mail starts
downloading very quickly, but it means that you can only download 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 unavailable while
downloading email.

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

The default behaviour (no concurrent POP3 connections) can cause email clients
to time out if several accounts are being checked (because POPFile only handles
one account at a time it can take a while to process all of the accounts).

If SSL support is being used then the default setting (no concurrent POP3
connections) _MUST_ be used otherwise POPFile crashes.

v1.0.0 RELEASE NOTES

If you are upgrading from pre-v1.0.0 please read the v1.0.0 release notes for
much more information:

 http://getpopfile.org/docs/ReleaseNotes:1.0.0

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 their time through patches, feature requests, bug
reports, user support and translations.

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

THANKS

Big thanks to all who've contributed to POPFile.

John.