home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / comm / avmnfax-1.33.lha / avmNfax-1.33 / GNU / EFAX.README < prev    next >
Text File  |  1994-05-26  |  3KB  |  75 lines
  1.               Introduction
  2.  
  3. This is the README file for version 0.6 of efax, a program to
  4. send and receive faxes using Class 1 or Class 2 fax modems.
  5.  
  6. efax is a relatively small ANSI C/POSIX program that provides the
  7. data transport function for fax applications.  A simple shell
  8. script (``fax'') is included in the distribution to let you
  9. create, send, receive and print faxes.
  10.  
  11. efax is smaller and easier to install than FlexFax, NetFax, or
  12. mgetty+sendfax.  It uses your system's own getty to handle
  13. incoming data calls. As one user put it, ``EFAX is a nice simple
  14. program for single user systems.''
  15.  
  16. In addition to efax you'll need Ghostscript (I used version
  17. 2.6.1), to create the fax image files and the PBMPlus utilities
  18. to convert the received fax to a format that you can print.
  19.  
  20. This version of the program was written & tested under Linux
  21. 0.99pl14, gcc 2.4.5 and libc 4.4.4.  Previous versions have also
  22. been compiled and used under AIX 3.2.4, BSD, IRIX 5.2, OSF/1V1.3,
  23. SunOS 4.1.1, SysVR4.2 and ULTRIX and should work with minor
  24. changes on any modern UNIX with an ANSI C compiler/library and a
  25. termios(4) serial device interface.
  26.  
  27. efax is distributed as a gzip'ed tar file, efax06.tar.gz.  It may
  28. be obtained by anonymous FTP from sunsite.unc.edu in
  29. /pub/Linux/Incoming or /pub/Linux/apps/comm.
  30.  
  31.     Changes to efax from version 0.5b to version 0.6
  32.  
  33. - supports Class 1 fax modems
  34.  
  35. - detects errors in received data and requests retransmission
  36.  
  37. - more robust terminal setup
  38.  
  39. - miscellaneous fixes and improvements
  40.  
  41.                 Manifest
  42.  
  43. The efax distribution should contain the following files:
  44.  
  45. README   - this file
  46. COPYING  - the GNU public license
  47. efax.c   - the source code
  48. efax.1   - a man page for efax(1)
  49. fax      - a Bourne shell script to create, send, receive and
  50.            print faxes.  Requires Ghostscript and PBMPlus
  51.            utilities.
  52. fax.1    - man page for fax(1)
  53.  
  54.               Installation
  55.  
  56. You'll need an ANSI C compiler, such as gcc, to compile the code.
  57. With gcc, do:
  58.  
  59.   gcc -o efax -O efax.c 
  60.  
  61. Modify the variables at the beginning of the `fax' shell script
  62. according to the comments. Copy the executable, script, and man
  63. pages to appropriate directories (probably /usr/bin and
  64. /usr/man/man1).  
  65.  
  66. The efax(1) man page has instructions on modifying /etc/inittab
  67. (SysV) or /etc/ttytab (BSD) so init(8) can run efax to handle
  68. incoming fax and data calls automatically.
  69.  
  70.                Bug Reports
  71.  
  72. Please send bug reports or suggestions to edc@ee.ubc.ca.  Please
  73. include copies of the session log and details about the modem and
  74. operating system you are using.
  75.