nxsmbfax.c [version 1.2] -- README

This is a "print command" program for SAMBA for sending
faxes from Windows applications through a faxmodem attached to a NeXT.

Briefly, from any Windows app., you just print to "Fax" printer,
this program makes a call-back to a pop-up panel application
(respond.exe) running on Windows, and collects info needed for
faxing (e.g., fax number, fax receiver's name, etc.).  It then
inserts this information into the PS file, and exec's lpr to queue
the job for faxing.  You can delay fax transmissions by
specifying a number of hours to delay.  This is not as flexible as
exact time specification allowd by the NeXT Fax panel, but should do
fine for most.

Requires working fax system such as NXFax on NS/OS.


SETUP
-----------------------------------------------------------------------
*** On Windows side:
Get RESPOND.EXE (freeware) from:
   http://www.boerde.de/~horstf/ or http://relay.boerde.de:82/~horstf/
Auto start RESPOND.EXE via STARTUP folder on Windows95/NT.
Configure RESPOND by a companion app CONFIGURE.EXE.
In particular do this:
Enable delayed transmission field as text area.
Relabel this field as "Number of hours to delay", because
  with nxsmbfax, delay is specified by the number of hours (integer)
  from now to call time.

After SAMBA is running, setup \\server\Fax as Apple LaserWriter NTX
(or if you have NeXT 400dpi Laser printer PPD file, as that).
Do NOT choose a HP or PCL compatible printers, as they generate PJL
junk prepended to real PS code.


*** On NS/OS side:
cp nxsmbfax /usr/local/bin
mkdir /usr/local/lib/fax
cp default.coverinfo /usr/local/lib/fax
(Additionally, create your own Fax cover info file as:
    youruserid.coverinfo [lower case] in the same directory.)

Setup SAMBA (smb.conf) with lines like:
--
; Add to your smb.conf
; %I: IP address
; %s: The name of the faxfile with path
; %U: The samba session setup user
; %m: The NetBIOS hostname

[Fax]
   comment       = Fax Modem faxmodem_fax
   postscript	 = yes
   print command = ( /usr/local/bin/nxsmbfax %I %s faxmodem_fax ) &
   printable     = yes
   writable      = no
   path = /tmp
---
where faxmodem_fax is the actual name of the fax modem in your system
(as passed to lpr via -P option).


### BUGS:
1. DSC comments are not quite legal, but works with NeXT Fax system.
   In particular %%Pages: 100 has a bogus large value which seems OK.
   %%Page: ? nn comments are not also correct (confuses Preview.app).

2. Stripping PJL junk for HP PCL printers is not in.  It does strip ^D chars.