WMpop3LB2.0
=================================

Written by Louis-Benoit JOURDAIN (lb@jourdain.org)

This software is based on Wmpop3-0.5.6 by Scott Holden ( scotth@thezone.net )

WARNING!!! WMPop3LB is to be used at your own risk. I will not be held
responsible for any damages this application may cause your system.

1) WHAT IS THIS
   WMPop3LB is a multi POP3 mail box checker. It will connect to up to 6
   POP3 servers to check if you have mail, get the "From:" and "Subject:"
   header fields of each mail and display them in a 7 lines window. 
   It can list up to 19 messages per server which can be read by scrolling
   the window up and down.
   Messages can be deleted directly off the servers by selecting the mails
   to delete and clicking the "delete" button.

2) How do I configure WMPop3LB
   WMPop3LB when first executed will check if there is a .wmpop3rc file in
   the users home directory, it will create this if it can not be located. 
   This file must be edited and the following fields must be changed :

-- before any [server] section:
    1) autochecking: This allows to disable or enable auto mail checking. 
       1 enables, 0 disables
    2) viewallmessages: This allows for alternating mail views upon startup, 
       0 shows the From: and Subject: header fields of each mail, 
       1 shows the total number of messages or the number of unread
       messages, per domain, and the number of selected messages.
    3) display delay: this will determine how long error messages are
                   displayed before the screen is cleaned up.
    

-- for each [server] section (you can list up to 6 [server] sections):

    1) popserver:  this is the name of the pop3 server to contact.
    2) port:	   this is the port the pop3 server is on ( default 110).
    3) username:   user's pop3 login name.
    4) password:   user's pop3 login password.
    5) alias:	   3 alphanum characters server alias name, to
		   differentiate servers in the display window.
    6) mailcheckdelay: Number of minutes, before checking mail on this server.
                  (default = 10 minutes)
    7) countunreadonly: in the counter view, 0 displays total number of 
                   messages on server, 1 displays only the number of unread
		   messages.
    8) mailclient: command to launch when clicking on the server line in
                   counter view mode.
		   The command, if containing spaces or special characters
		   must be written between double quotes (`"').
		

3) Using WMPop3.

    1) If you have no mail, WMPop3LB will show "No mesg" and will count down
       the time before the next cheking.
       If none of the configured server can be contacted, WMPop3LB will
       show "ERROR" and will count down the time before the next checking.
           
    2) If you have mails, WMPop3LB will display a line for each mail, with
       the message number and will start scrolling the line, showing the
       server alias identifier, the "From:" and "Subject:" header fields
       in the following format:
	  "alias:<from field>/<subject field> * "
    
    3) Depending on the option chosen for viewallmessages, it will display 
       either:
	
	a) the alias, The From: and Subject: fields of each mail as 
	   described above.
	b) The total number of messages or the number of unread messages
	   (depending on the configuration parameter "countunreadonly") on
	   the POP3 server (if the server has been contacted successfully)
	   as well as the number of messages selected.
	   If the server cannot be contacted, it will show one of the
	   following error message:
		     - alias: C*ER  --> connection error
		     - alias: L*ER  --> login error (wrong login or passwd)
		     - alias: M*ER  --> can't get mails.

       * The far most right button is used to toggle both views.
    
    4) To delete one or more messages directly off one or more servers,
       select the messages you want to delete and then click on the bottom
       left "DEL" button.

       You can checked how many messages are selected by switching view
       mode.

       A status per server will show up during "displaydelay" seconds with the
       following error codes:
		 - OK: messages were deleted successfully from the server
		 - NONE: no messages were selected for this server
		 - D:nb: nb messages failed to be deleted.
		 -  Err: an error has occured (connection or else).
       
       WMPop3LB will not allow you to delete messages if the content of the
       mailbox on the server has changed since last checking.
       It will instead display an error message ("mailbox content has
       changed between updates del can.") and reload the content of the
       mailbox from the server.
       
    5) To manually check for mail at any time, mouse click on the 
       2nd button from the left, with a round arrow.
    
    6) To turn off auto mail checking, mouse click on the "ch" button (second
       from the right).

    7) If you have more than 7 messages on all your servers, and up to 19
       messages per server, you can scroll the window up and down using
       the up and down arrows.

       WMPop3LB will only display the first 19 messages of each server. If
       you have more than 19 messages, it will only display the 19 older
       messages.