CMAIL(1)

NAME
cmail - a simple mail counter

SYNOPSIS
cmail [-dnh] [-c config]

DESCRIPTION
cmail reads in ~/.cmailrc for a list of mailboxes names and mailbox paths (full paths) and checks each box for new and old mail. It the prints out the description, and the number of total messages, followed by the number of new message if there are any. Command line options are:

-d  enables debug mode, printing what cmail is trying to do

-c  lets you specify a different config file

-n  disables the use of color

-h  prints a helpful help message

CONFIGURATION FILE
The cmail configuration file contains a number of lines, each describing a single mailbox to check. Each line has three fields, a box URL, a description, and an optional color. Each field is seperated by one or more tabs. For example, the following is an entry for /var/mail/chip:

 file:///var/mail/chip  Inbox      green

If Net::POP3 is installed, you can also have cmail check for mail in POP3 mailboxes, using config lines like:

 pop3://user:passwd@mailhost/   POP3 Box        yellow

For a list of accepted colors, check Term::ANSIColor.

OPTIONAL COMPONENTS
For some added features, you may want to install some of the following Perl modules

Net::POP3
    Adds the ability for cmail to display number of messages waiting on a POP3 server

Term::ANSIColor
    Adds spiffy color ability to cmail

Compress::Zlib
    Allows cmail to read gzipped mailboxes

FILES

~/.cmailrc
    cmail configuration file

AUTHOR
Chip Marshall <chip@chocobo.cx> http://www.chocobo.cx/chip/