asfaces(1.0pre3)

NAME
asfaces - the AfterStep mail faces application

SYNOPSIS
asfaces [-noscroll]

DESCRIPTION
The asfaces application is a mail monitor for the AfterStep window manager. It reads the file specified in the MAIL environment variable, parses it, and displays in succession an image representing each person who sent you mail and the number of messages each person sent you in the upper left hand corner of their image. The application reads the file .asfaces in your home directory (specified in the HOME environment variable) for configuration information. The format of the file is as follows:
mused@sco.muse.usa    /home/mused/images/asfaces/mused.xpm
mused@company.com    /home/mused/images/asfaces/mused.xpm
dmuse@engr.latech.edu    /home/mused/images/asfaces/mused.xpm
user1@company.com    /home/mused/images/asfaces/company.xpm
user2@engr.latech.edu    /home/mused/images/asfaces/latech.xpm
and so forth. The format breaks down into basically 2 fields per line; the first is the full email address of the person and the second is the full pathname of the xpm format image representing them. In the directory specified by the LIBDIR compilation definition (probably either /usr/local/lib/asfaces or /usr/lib/X11/asfaces) there are 2 special purpose images called nomail.xpm and default.xpm. nomail.xpm appears in the window when you have no mail. default.xpm appears when in place of all unknown senders.

CONFIGURATION OPTIONS
-noscroll : Normally asfaces displays images which scroll from right to left
        over top of one another. This can be terribly costly to a
        network if the machine that asfaces is running on is not the
        machine the display is on. For this reason, the noscroll
        option is provided to make asfaces simply print one icon
        directly on top of another with no scrolling at all.

INVOCATION
asfsm can be called from one of many ways. The most common invocation is the command line:
	[user@host] ~% asfaces
Another way to call asfaces is from the window manager:
	*Wharf - - MaxSwallow "asfaces"	asfaces &
This line, when placed in the .steprc file in the users home directory will cause asfaces a button on the Wharf (1) button bar under the afterstep (1) window manager.

COPYRIGHTS
GNU GPL v2

AUTHOR
David Muse <dmuse@engr.latech.edu> -- application and man page.

ACKNOWLEDGEMENTS
Thanks to Christopher B. Liebman (liebman@zod.clark.net). The idea for asfaces came from his xfaces application.