			  Introduction

This is the README file for version 0.7a of efax, a program to
send and receive faxes using any Class 1 or Class 2 fax modem.

efax is a relatively small ANSI C/POSIX program that provides the
data transport function for fax applications.  A simple shell
script (``fax'') is included in the distribution to let you
create, send, receive, view and print faxes.

efax is smaller and easier to install than FlexFax, NetFax, or
mgetty+sendfax.  It uses your system's own getty to handle
incoming data calls. As one user put it, ``EFAX is a nice simple
program for single user systems.''

The package now includes the ``efix'' program to convert text,
fax or PBM files into fax, PBM, PGM, HP-PCL or Postscript files.
To fax Postscript images you will need Ghostscript.  To preview
faxes you will need a PGM file viewer (e.g. xv or xloadimage).
If you don't have a PCL or Postscript printer you will need an
appropriate conversion program (e.g. pbmtoepson or Ghostscript) .

This version of the program was written & tested under Linux
0.99.14.  Previous versions have been compiled and used under AIX
3.2.4, BSD, HP-UX, IRIX 5.2, NeXT, OSF/1V1.3, Solaris 2.x, SunOS
4.1.1/4.1.3, SCO 3.2.0, SysVR4.2, and ULTRIX 4.3 and should work
with minor changes on any modern UNIX with an ANSI C compiler and
library including select(2) and termios(4).

efax is distributed as a gzip'ed tar file, efax07a.tar.gz.  It
may be obtained by anonymous FTP from sunsite.unc.edu in
/pub/Linux/Incoming or /pub/Linux/apps/comm/fax.

	    Changes from version 0.7 to version 0.7a

- fixed bug in efix that dropped the last line on each page

- fixed bug that caused training check to fail with some modems

- added a Makefile

	    Changes from version 0.6a to version 0.7

- includes the "efix" program to convert between file formats (no
  longer requires Ghostscript or PBM utilities)

- generates page headers using a built-in or external PBM font

- resets START and STOP characters to XON and XOFF (fixes some
  flow control problems)

- retains modem responses generated during data transmission
  (fixes problems with USR Sportsters)

- isolates Unix dependencies to simplify porting to other
  operating systems

- computes accurate timeout for draining modem's transmit buffer

- enables "software carrier" if available

- many minor bug fixes and improvements

			    Manifest

The efax distribution should contain the following files:

README     - this file
COPYING    - the GNU General Public License
Makefile   - makefile to make all/install/clean
efax.c     - program to send and receive faxes
efix.c	   - program to convert between file formats 
efaxlib.h  - header file for functions common to efax and efix 
efaxlib.c  - functions common to efax and efix 
efaxos.h   - header file for OS-dependent functions
efaxos.c   - OS-dependent functions
fax.1      - man page for fax(1)
efax.1     - man page for efax(1)
efix.1     - man page for efix(1)
fax        - a (Bourne) shell script to create, send, receive and
             print faxes.
efaxfont.h - 204x198 dpi 10-point Courier font
efaxfont.l - 204x96  dpi 10-point Courier font

			  Installation
	
Edit the makefile and change the compiler and the destination
directories if required.

Type "make" to build the efax and efix binaries.  

Modify the variables at the beginning of the `fax' shell script
according to the comments.  

Type "make install" to install the binaries and man pages.

The efax(1) man page has information on resolving problems and
describes how to modify /etc/inittab (SysV) or /etc/ttytab (BSD)
so efax can handle incoming fax and data calls automatically.
