#	$Id: README 2 2005-11-11 21:32:03Z faxguy $
#
# HylaFAX Facsimile Software
#
# Copyright (c) 1990-1996 Sam Leffler
# Copyright (c) 1991-1996 Silicon Graphics, Inc.
# HylaFAX is a trademark of Silicon Graphics, Inc.
# 
# Permission to use, copy, modify, distribute, and sell this software and 
# its documentation for any purpose is hereby granted without fee, provided
# that (i) the above copyright notices and this permission notice appear in
# all copies of the software and related documentation, and (ii) the names of
# Sam Leffler and Silicon Graphics may not be used in any advertising or
# publicity relating to the software without the specific, prior written
# permission of Sam Leffler and Silicon Graphics.
# 
# THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
# EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
# WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
# 
# IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
# ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
# OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
# WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
# LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
# OF THIS SOFTWARE.
#

It's easy to setup an email to fax gateway with these simple steps:

1. Setup the HylaFAX software as usual.

2. If your system uses sendmail to deliver mail, then follow the
   instructions in mailfax.sh-sendmail.

3. If your system uses smail (e.g. Linux users), then follow the
   instructions in mailfax.sh-smail.

4. If your system uses qmail to deliver mail, then follow the
   instructions in mailfax.sh-qmail.

5. If your system uses Postfix to deliver mail, then follow the
   instructions in mailfax.sh-postfix.

6. Restart your mail software, refreeze your configuration or
   whatever is necessary to cause the configuration changes to be
   seen by the system.

Voila!  Now mail to user@dest.fax will get formatted and submitted as a
facsimile job to "user" at the specified "dest".  By writing a more
involved mailfax script you can add things like different resolutions
by parsing the "user" string.  For example, an X.400-style scheme might
use:

    user/R=low/N=done@host.fax

where "R=low" specifies a low res facsimile and "N=done" requests
notification when the job is done.  If you want symbolic destinations,
then you can provide a host to phone number mapping facility.

NOTE: The normal access control mechansims on submitting a facsimile
for transmission are enforced--you may need to use them if you create
an email to fax gateway on your machine!

Dirk Husemann's more elaborate scheme is included in the contributed
software; check out ../contrib/dirk.

There is also the "Remote Printing Experiment" being conducted by folks
on the Internet.  This provides a distributed fax delivery service that
uses email to relay facsimile to a local site for delivery.  For info
about that stuff send mail to tpc-faq@town.hall.org.

	Sam
