----------------------
mailblink ver 0.3
----------------------

1. Overview.

Mailblink is a small program that was inspired by a similar beast
called mailleds.  I wrote it because mailleds didn't quite work
for me.  Its purpose is to monitor your incoming mail file and
blink one of the keyboard leds when you have new mail.


2. How it works.

Mailblink monitors the last access and modification times of your
mailbox to determine when you have new mail.  Since it never
reads the mail file itself, it should not interfere with other
notification programs.  It also means that you can monitor a file
that you cannot actually read.  You may wish for example to
monitor the root mailbox for unread mail and just "su" when you
want to read it.

Up to three files may be monitored (since there are 3 leds on a
keyboard).

The actual blinking of the leds is controlled by the (EUID root)
program led which was written by Anders Johansson.

3. Things you might not quite expect.

If mailblink detects subsequent updates to your mailbox, it
will increment the number of blinks the led makes.  This is not a
perfect count of your messages, since you may receive two
messages between intervals which will only be counted one time.
It is also possible for a single message to be counted twice if
it happens to be only half saved when mailblink checks the file.
With these disclaimers aside, roughly more blinks means more mail
for you to read.  A little more finesse could make this exact,
but I am content with the behavior as it is.

4. Compiling and Installing

Well, one can hope this is simple enough to compile without fuss
(there are some warning messages on some systems that appear not
to cause any harm) by typing:

 > make

You need to be root to install:

 > make install

5. Running

The simplest way to run mailblink is with:

 > mailblink

By default the program will monitor the file specified in your
MAIL environment variable every 30 seconds and blink the scroll
lock led when it has been modified.

To remove (kill) the program you just started, you should be able
to type:

 > mailblink -k

To watch the file /home/don/Mail/mylist at 60s intervals and
blink the numlock key you can type:

 > mailblink -f /home/don/Mail/mylist -d 60 -l num

And to kill this you can type:

 > mailblink -k -l num

