README:

TKFAXSPOOL is a Frontend for mgetty's faxspool/faxrm/faxq fax sending programs.

Using your  modem under  LINUX,   "mgetty"  modem software controls  the
low level calls to your modem.  TKFAXSPOOL   is a Frontend that provides
a Graphical User Interface(GUI) under  X11, KDE or Gnome. TKFAXSPOOLis a
TCL/TK  script  that allows you send facsimiles. It also lets you build and
maintain a FAX-ADDRESS-BOOK of recipients. TKFAXSPOOL allows you to view
outgoing FAX's with Ghostview. TKFAXSPOOL can be invoked with a special
command line argument "-f /path/filename" to add files to the "FILES to FAX"
list. This is useful for building a FAX-Printer so you can FAX the output
from any program that has a print button. TKFAXSPOOL can also call TKVOICE
so you can view your incoming FAX's and listen to your voice messages.


------------------------------------------------------------------------
To use TKFAXSPOOL as a lpd style FAX-PRINTER:
------------------------------------------------------------------------
edit your /etc/printcap and add the following lines:

FAX:\
   :lp=/dev/null:\
   :sd=/var/spool/fax/printer/tmp:\
   :lf=/var/spool/fax/printer/logfile:\
   :af=/var/spool/fax/printer/acct:\
   :if=/var/spool/fax/printer/filt/FAX.flt:\
   :mx#0:sf:sh:

then create the directories:

   mkdir /var/spool/fax/printer
   mkdir /var/spool/fax/printer/tmp
   mkdir /var/spool/fax/printer/filt

and copy the FAX.flt script to the /var/spool/fax/printer/filt directory.
You may have to edit the script as it was written for Slackware but it should
be close. (the script is in this directory) and looks like this:

#!/bin/sh
# filter location: /var/spool/fax/printer/filt/FAX.flt
#
# FAX FILTER CREATES a PostScript FILE to load into tkFaxSpool for FAXing
#
PSFILE=tkfaxspool.ps
PATH=/usr/local/bin:/usr/local/netpbm/bin:/usr/bin:/bin:/usr/X11R6/bin
DISPLAY=localhost:0.0
USER=$5
LOGNAME=$USER
if [ "$USER" = "root" ]
then
  HOME=/$USER
else
  HOME=/home/$USER
fi
PID=$$
# remove old PS file
rm -f /$HOME/$PSFILE
# create the PostScript file for faxspool
cat  > /$HOME/$PSFILE
# call the gui program
tkfaxspool -display $DISPLAY -f $HOME/$PSFILE
exit $?

------------------------------------------------------------------------
WHAT'S NOT INCLUDED :
------------------------------------------------------------------------

TCL/TK"     
 I wrote this app for wish v8.3 of the  tcl/tk  GUI manager but
 should work with older versions.  Most modern distributions of
 LINUX come with tcl/tk pre-installed.
 Available from: http://www.tcl.tk/

"TIX"   I wrote this app with tix v8.1 tcl/tk extensions but it should
    work with older versions of tix.  Most modern distributions of
    LINUX come with tix pre-installed.
    Available from: http://tix.sourceforge.net/

"mgetty" Is part of "mgetty+sendfax" package vgetty needs to be properly
         installed and configured. (will work with vgetty too)
         Available from: http://alpha.greenie.net/mgetty/


------------------------------------------------------------------------
TKFAXSPOOL REQUIREMENTS :
------------------------------------------------------------------------
SOFTWARE:
        - Probably any kernel released as 2.0 or later is a safe bet,
        - tk/tcl installed and "wish" is somewhere in users PATH
        - tix    installed and "tixwish" is somewhere in users PATH
        - mgetty installed and faxspool,faxrm are somewhere in users PATH
        - faxrunqd installed and running at boot time.

HARDWARE:
        - Modem for send FAX support.

------------------------------------------------------------------------
TESTED ON:
------------------------------------------------------------------------

        - Slackware v8.0 for Intel i686
        - tk/tcl v8.3
        - tix-8.1
        - Linux Kernel releases: 2.2.19 and 2.4.17
 
------------------------------------------------------------------------
HISTORY :
------------------------------------------------------------------------
 
0.1     Released Aug 1st 2002.
 
------------------------------------------------------------------------
TKVOICE USAGE :
------------------------------------------------------------------------
 
        tkfaxspool
 
        tkfaxspool -f /path/filename
 
 
------------------------------------------------------------------------
INSTALLATION :
------------------------------------------------------------------------
 
See the included file INSTALL for details about installation.
 
End of README.