QUICK INTRO

The newfax extensions for mgetty+sendfax provide support for handling of
inbound mgetty fax documents.  Inbound faxes can be routed selectivily
based on the station id of the sender using /etc/mgetty+sendfax/faxdist.
Selective routing can be specified to either ignore a fax source, route
to a specified print queue for immediate printing, or to an email account.

The dist file accepts entries in the form 'station id':'proper name': 
'destination'.  If 'destination' is left blank, then all faxes
received from that station id will be ignored (logged in /var/log/faxlog
and deleted).  If the destination matches a name of a known 'printer' in
/etc/printcap, then the fax is routed to that HP Laser Jet printer.
Otherwise, 'destination' is assumed to be an email address of some sort.

When faxes are emailed, they are converted to a single MIME email document
composed of a seperate .gif image for each page of the fax using the
newfax2mime script.   Printing is only supported on HP LaserJet compatible
printers via newfax2hplj at this time.

Newfax is developed from many of the concepts found in other contributed
scripts for handling inbound faxes that are part of the normal mgetty
package.  As such, this is a seperately derived script set that has
proven more functional and reliable than many of the examples provided
for mgetty, uses no temporary work files, and has been adapted
specifically for use with RedHat Linux.  

Newfax is freely usable and redistributable, and certainly may be
resubmitted for inclusion as contributed mgetty sample scripts.  In
addition, a log rotate file is provided for mgetty with this newfax
package, since this omission in the original RedHat mgetty package has
been a problem.

OTHER NOTES

The dist.sh script is used internally to prepare the source tar and
install.sh is used to produce the 'install' set during RPM processing
for properly ordered file installation. Most people can ignore it.

All comments, complaints, and great thoughts may be e-mailed to David
Sugar <dyfet@tycho.com>.



