KNewMail README
---------------

What Is KNewMail
----------------
KNewMail is a small utility for KDE which monitors multiple mailboxes
for email. When email arrives, KNewMail uses "Notifers" to alert the
user of the waiting email.

Please Note that KNewMail was completely rewritten for KDE 2.x. The
rewrite introduced a lot more flexibility into the application, but
also made it incompatible with the old configuration file format. You
will need to reconfigure this version.

Requirements
------------
KDE 2.x
Qt 2.x
librmm - Available in kdepim

Installation
------------
You must download and install librmm first! This library can be found in
the KDEPIM package, which can be downloaded from the kde cvs or one
of the cvs snapshots found on ftp.kde.org.


 ./configure
 make
 make install

If for some reason that doesn't work, see the INSTALL file for detailed
installation instructions.

Using
-----
KNewMail is simple to use, however it differs greatly from previous
versions. After installing, Run 'knewmail'. This should bring up the main
window of the application. The next step is to choose some plugins to
use. To do this, choose Settings->Configure.

To make KNewMail useful, you will want to add some notifiers. Click on the
Notifiers panel on the left of the config dialog. This should show an
empty list of notifiers. Click the Add Button. Choose the type of notifier
you want to add. Most people who used the old version of the application
will want to enable the ListView and AnimDock notifiers. After you add a
notifier, you will be asked to configure it. Most notifiers will only let
you configure the name, but hopefully this will change in the future.

You can add multiples of the same notifier, so if you want two sounds
to play or two animations in the panel, just add two of the notifiers. Note
that most notifiers work best if only one is installed (like the ListView),
but it is possible to have multiples.

After adding notifiers, you will want to add some accounts. Click the Accounts
panel to view the now empty account list. Adding accounts works just like
adding Notifiers.

Once you have added all the accounts you need, close the config dialog. All
the notifiers should now become active. You can click the Check Mail button
to check your mail. If you are using the ListView notifier, a list of
messages should appear. You can click on a message to select it. Depending
on your KDE setting, a single or double click will mark the message for
deletion (as shown by a small red circle on the left). The next time you
check your mail, if the protocol supports it, the marked messages will be
deleted. Currently deletion support is enabled in POP3 and IMAP4 (when it
is ready).

New Version
-----------
The newest version of KNewMail should always be available at
http://www.slac.com/~mpilone/projects/knewmail/

License
-------
KNewMail is release under the GPL (GNU General Public License). Therefore,
you may copy and distribute it as you like. More information can be
found in the file COPYING


Questions, Comments, Feedback, and Job Offers are always welcome at
mpilone@slac.com


-mike
Mike Pilone
mpilone@slac.com
