Rather than write a new description, I'll include the man page:


AmigaFaces								AmigaFaces


NAME

	AmigaFaces 1.0 - Universal mail notifier for UUCP and SMTP
        Systems (in.smtpd or InetUtils v1.4)

SYNOPSIS

	faces

DESCRIPTION

	AmigaFaces is a program to be used as a mail filter. It can
	start other programs depending on the incoming mail's sender.
	Thus, you can i.e. let your Amiga sing "Halleluhjah" whenever
	a mail from your girlfriend arrives or swear loudly when mail
	from the company is received.
	

INSTALLATION

	Copy faces somewhere in your search path. Copy faces.db to
	AmiTCP:db, UULib: or S:. If you don't have one of these, you
	don't have an Amiga. AmigaFaces is not for you.
	
	Change faces.db to suit your needs. (This file is well
	commented and should be pretty self-explanatory.

	Edit your aliases file, most propably UULib:aliases or
	AmiTCP:db/aliases. For every user whose mail shall be
	processed by faces, add a piping entry. Example:

	foo: \foo, "|faces"

	For the ones without a sound collection of their own I have
	included a "Halleluhjah" and a "DingDing" sound to have
	something to start with. I strongly recommend AmiSOX, which
	can be found on Aminet and converts virtually all formats to
	Amiga IFF (8svx) sound.

	That's all.


NOTES

	The way this program works is easy: It is invoked by the
	rmail-type part of your mailsytem and is given the mail as
	its input. It extracts the sender's EMail-address and then
	looks up faces.db to see if an action is defined for this
	address or class of addresses. If one was found, faces
	performs the corresponding action.

	See the example faces.db for additional documentation.


DISCLAIMER

	No cost - no warranty. Although I really can't imagine what
	harm the proper or improper usage of AmigaFaces could do to
	your system or data integrity, I must, of course, deny any
	responsibility for incidetal or consequential damages 
	whatsoever. Smile. Relax. Enjoy.

	AmigaFaces, that is all part of this distribution except for
	the sounds, is Copyright 1994 by Andreas Oesterhelt. All
	rights are strictly reserved. Permission is granted to
	distribute and use, AS LONG AS NO PROFIT IS MADE HEREOF.
	Violators will be towed ;-)

	The author can be reached on the net as oesi@paradis.rhein.de
	I would be glad about your comments, greetings, curses, etc.



BUGS/TODO
	
	I have extensively tested faces with AmigaUUCP rmail, the
	in.smtpd for AmiTCP 3b and shortly with SMTPd fom InetUtils
	1.4. So far, no bugs are known.

	I am thinking about adding a switch for the faces.db entries
	that will make piping the mailbody to a command possible. Thus
	one could i.e. have messages from selected people displayed 
	without entering one's mailreader.

	Also, the matching of the sender's name should become case-in-
	sensitive.

	If requested, different db files for different users are
	imaginable.


DIAGNOSTICS

	To test your faces.db without requesting hundreds of people to
	send mail, you can invoke faces from the command line and then
	type in a From: line, terminated by Ctrl-\ (EOF). Faces will
	try to execute the predefined action and errors of either
	faces or the invoked application are displayed in the shell.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  958    1870  51.2% -lh5- 53df Dec 11  1994 faces.db
[generic]                 1671    3155  53.0% -lh5- e239 Dec 11  1994 faces.man
[generic]                11023   16657  66.2% -lh5- a61f Nov 30  1994 halleluhjah
[generic]                 7851   17652  44.5% -lh5- de48 Dec 11  1994 dingdong
[generic]                 6373   10120  63.0% -lh5- b2ec Dec 13  1994 faces
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         5 files   27876   49454  56.4%            Dec 15  1994