# $Id: README,v 1.4 2004/03/22 18:49:22 baum Exp $

PopWash is a simple graphical application to delete messages on a pop3
server without downloading the message bodies. The mail headers are
filtered based on user defined black and white lists and presented in
a list where additional manual changes are possible.

The newest version of PopWash can be found at 
http://www.dr-baum.net/popwash
PopWash requires Tcl (http://sourceforge.net/foundry/tcl-foundry) and
the Gnocl library which is available at http://www.dr-baum.net/gnocl

I use PopWash every day. Nevertheless, to quote from the license:
<quote>
IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
 
THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.  THIS SOFTWARE
IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE
NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
MODIFICATIONS.
</quote>

The black-list and GUI only mark the mails for deletion. But as soon
as the "Delete" button in the toolbar is pressed and the deletion
process has finished, the mails are gone! There is no way to retrieve
them!

The usage step by step:
1) Enter in the preferences dialog the server and the user name of 
   your pop3 account and close the dialog by pressing "Ok".
2) Press the "Refresh" icon in the toolbar. 
3) Enter the password for the pop3 acount. PopWash connects to the server,
   downloads the header of all available mails and marks them based on 
   the white and black list.
4) After the mails have been downloaded, deselect those which shouldn't
   be deleted and select those which should be deleted.
5) Press the "Delete" icon in the toolbar. The marked mails are deleted
   on the server and PopWash disconnects from the mail server.

The download and the deletion can be stopped by either pressing
the "Stop" button in the toolbar or by hitting the "Escape" key. If this
is done during deletion, the user is asked whether the mails already
processed should be really deleted or not. THIS IS THE LAST CHANCE
TO RECOVER THE MAILS MARKED FOR DELETION!

To get the full power of PopWash fill the black and/or white lists
in the preference menu. Mails matching one or more fields of the
white list are never marked for deletion. Mails matching one or more
fields of the black list (and not matching the white list) are marked
for deletion. They are only marked for deletion, that means, that until
the "Deletion" icon is pressed they can be unmarked in the GUI by simply 
deselecting the associated check button.

A right click on the mail list shows a popup. This contains entries
for marking and de-marking of the selected mails. If only one mail
is selected it can be used as blueprint for the white and black list.

