====================================
POP-Gatekeeper (AKA Mail Dispatcher)
          Version: 0.7.1.1
------------------------------------
Copyright  2005 by Brana Bujenovic
        All Rights Reserved
====================================

Features
========

POP-Gatekeeper Plug-in provides mail-on-server monitoring, for e-mail accounts specified via Eudora mail client.

That way, user can delete unwanted mail from the server, before downloading it with Eudora, and hence avoid junk/virus/bulk mail.

Installation
------------

To install the program:
1. Close Eudora.
2. Unzip the content of dispatcher.zip to Eudora's Plugins folder. There are 3 files: dispatcher.dll, dispatcher.txt and dispatcher.bat.

To un-install the program:
1. Close Eudora.
2. Navigate to Eudora Plugins folder.
3. Delete: dispatcher.dll, dispatcher.txt, dispatcher.bat and dispatcher.log.

Getting Started
---------------

There are two ways to start POP-Gatekeeper:
1. Via Command Prompt
To start the program this way do one of the following:

1.1.	Open the Command Prompt window
		Navigate to the Plugins folder
		Type: rundll32 dispatcher.dll,POPGatekeeper
	
1.2.	Open the Command Prompt window
		Type: rundll32 [full path to dispatcher.dll],POPGatekeeper

1.3.	Create bat-files and then start the program by starting the bat-files or by starting shortcuts for the bat files.
		To create the shortcut for bat-file:
		Right click on the bat file, and select: Sent to/Desktop (create shortcut)

2. Via Eudora Tools menu
To start the program this way: Start Eudora, and click Tools/POP-Gatekeeper...

Command-Line Switches
---------------------

/connect [account name/Eudora personality]	<=>	connect specified account on the start-up
/folder spool								<=>	connect Spool folder on the start-up
/folder temp								<=>	connect Temp folder on the start-up
/version									<=> open About box

Examples:
start rundll32 dispatcher.dll,POPGatekeeper /connect Lycos
start rundll32 dispatcher.dll,POPGatekeeper /connect MyFirstEMailAccount

Note: To auto-connect the Dominant personality type Dominant without brackets:
start rundll32 dispatcher.dll,POPGatekeeper /connect Dominant --> no brackets

start rundll32 dispatcher.dll,POPGatekeeper /folder spool
start rundll32 dispatcher.dll,POPGatekeeper /folder temp

Personal & Junk Lists
---------------------

Messages can be flagged as Junk or Personal, according to 3 criteria: From, Subject and To filed.
a) Junk-message criteria are added to the Junk-list, and all the future messages that satisfy the same criteria are automatically flagged as Junk.
b) Personal-message criteria are added to the Personal-list, and all the future messages that satisfy the same criteria are automatically flagged as Personal.
This feature supports Regular Expression, so it's possible to specify particular domain, part of the message subject, or senders name for instance, only once. Here are few examples:

Text Field			Matches							Doesn't Match

^John				John Smith <smith@domain.com>	Smith <smith@domain.com>
					John Doe <doe@dot.com>
					john@dot.com
					
.*@domain\.com.		John Smith <smith@domain.com>	My Friend <MyFriend@aol.com>
					Smith <smith@domain.com>
					mally@domain.com

There are many Regular Expression examples and manuals on the Internet, here are the few:
http://en.wikipedia.org/wiki/Regular_expression
http://www.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap09.html
http://www.regular-expressions.info/

POP-Gatkeeper uses POSIX Regular Expression locale. All searches are case insensitive.

What's New
==========

* Fixed a bug where per account (Eudora Personality) values would not be inherited from a default account (Eudora Personality), if not specified (per account basis), when the default (Dominant) account is IMAP. This applies for values that can not be set via Eudora's GUI.

* Fixed a bug where Network Timeout value would be calculated in milliseconds instead of seconds.

+ POP-Gatkeeper now supports Eudora's Network Open Timeout option.
$ If that time expires, dialog appears prompting to disconnect or stay connected.
$ Note, other value, Network Timeout, is the time given to server to respond. Network Open Timeout is the time we wish to stay connected (once the connection is established).

* Closed a memory leak that would occur if program is closed via x-button at the top right corner.

+ POP-Gatekeeper main window now contains Minimize-button, if it runs stand-alone.

+ Command-line switches (if program runs stand alone). Please see Features/Command-Line Switches section of this document for details.

+ POP-Gatekeeper now fully supports multiple instancing.

$ To simultaneously auto connect on several accounts (to check one account via 1st program instance, and the another one via second instance) just start 2 bat-files.

$ To start one instance after another, start the bat file(s) that contains similar lines:
start /wait rundll32 dispatcher.dll,POPGatekeeper /connect MyFirstEMailAccount
start /wait rundll32 dispatcher.dll,POPGatekeeper /connect MySecondEMailAccount

# Improved date sorting.

+ About-box hot key: Shift+F1

# Updated this Release Notes.

Version History
===============

Version 0.7.0.1
---------------
+ Now it's possible to start POP-Gatekeeper from a command line (without having to load Eudora first). To do so type:
	start rundll32 dispatcher.dll,POPGatekeeper
or
	start rundll32 [full dispatcher.dll file path],POPGatekeeper
$ Sample bat-file is included in the zip-archive.

## Misc improvements.

Version 0.6.2.4
---------------
* Fixed a bug that would cause a crash if Junk/Personal-list contains empty line.
+# New, plain C/C++ RegExp implementation.
-# Removed obsolete 3rd party RegExp libraries.

Version 0.6.2.1
---------------
+ Message-headers list columns now contain images.
+ Another special folder: "Temporary Folder"
$ Active-user temporary folder is added to the accounts panel. All files, which name starts with "eud", are displayed.
$ This feature allows us to easily delete some temporary files created (and not deleted) by Eudora.
+ Selected message: "Save & Open" (Ctrl+Shift+S)
$ Message will be downloaded to the temporary folder, with extension "txt", and opened. Default Windows application (for txt-files) will be launched. To set up another extension the just change "SaveAndOpenExtension" key under the "Settings" entry of dipatcher.ini.
+ Message-list actions:
a) Select All 			- Ctrl+A
b) Select All Personal 	- Alt+P
c) Select All Junk 		- Alt+J
d) Select All Neutral	- Alt+N
+ Preview Pane
$ Now it's possible to review the full message headers for the mail on server.
* Fixed a bug that would prevent changing/clearing flags on-the-fly, therefore causing messages that satisfy the same criteria to be automatically flagged on the next log-on.

Version 0.5
-----------
+ Now it's possible to specify additional accounts configured via different Eudora-ini files. To do that add the following section and lines to "dispatcher.ini":
[EudoraSettingsFiles]
c:\mymail\eudora.ini=on
d:\myothermail\eudora_alt.ini=off
etc.
So there are 3 parameters:
a) Full eudora-ini file path.
b) Equals sign (=)
c) on/off switch
+ Subject & To fields now can be added, as new criteria, to the Personal/Junk lists.
+ Added support for Regular Expression.
- "On-the-fly" Clear flags (triggered from the toolbar button) will clear only literals (from the list) for now (From-field).
+ Accounts panel now contains one extra item: Spool-folder. When opened, this folder will display, summaries, for messages from Eudora's Spool-folder. All files with extensions "rcv", "snd" & "tmp" are considered message-files.
+ When Eudora starts, and there are pending messages at the Spool folder, POP-Gatekeeper will start up and allow user to review summaries, delete, save or flag (un)wanted mail. This should also prevent from infinite loops if case of incorrect MIME formatted (read malicious) mail messages.
$ Pending Messages Plugin therefore declared deprecated. If you are currently using Pending Messages Plugin, you can safely delete "spool.dll".
# Misc. graphical changes. There are some more road signs.

Version 0.4
-----------
+ Personal List (All messages now can be classified into 3 groups: Junk, Personal and Neutral. Neutral messages are those messages not present on Junk or Personal lists.)
+ Junk/Personal List Editor
+ Add to Junk/Personal List Options
To use this feature, select one message and hit Ctrl+Shift+J (for junk messages) or Ctrl+Shift+P (for personal messages).

Version 0.3
-----------
# Faster download speed.
+ Task status panel.
+ Progress bar.

Version 0.2
-----------
# More tolerance towards different (Eudora specific) login-names.
+ Multi threading.
+ Logging (for now, only some errors are logged).
- Save message to file option.
+ Full APOP support.
## Faster overall program execution
*** Bugfixes.

Version 0.1
-----------
Initial release.

What's New & Version History Legend
===================================

+ New feature
- Removed/Obsolete old feature
* Bugfix
# Improvement

Disclaimer of Warranty
======================

This software is provided on an "As Is" and "As Available" basis without warranties of any kind, express, implied or statutory, including but not limited to, the implied warranties of title, noninfringement merchantability and fitness for a particular purpose. I do not warrant that the software will be - uninterrupted, timely, reliable, secure or error-free and expressly disclaim any warranties as to the program contained herewith.

Credits
=======

"regex" written by Henry Spencer.
"POSIX" is a registered Trademark of The IEEE.

Release Date
============

August 18th 2006

