This is a test version of spandsp-0.0.2

If you want a stable version, don't use this one. The app_rxfax.c and app_txfax.c programs in this directory will only work with spandsp-0.0.2.

pre1 had the XML for global tones missing.
pre2 still have an XML file error. t31.c also mistakenly included audiofile.h

pre3 now has improved V.27ter and V.29 receive modems.


BUILDING AND INSTALLING SPANDSP AS A FAX MACHINE FOR ASTERISK

You will need TIFF version 3.5.7 or later installed on your machine. Make sure
no earlier version is there - they seem to cause crashes. TIFF 3.6.1 has serious
bugs in its FAX handling, but patches exist to fix these. Some distributions
using 3.6.1 seemed to be patched these days. Debian seems OK. Mandrake with the
latest patches should be OK. Fedora Core 3 tests are not, but a bug report has
been submitted. 3.7.0beta2 seems to have a fresh new bug in FAX handling.

The spandsp library may be built by unpacking the spandsp-0.0.2.tar.gz tarball,
cd'ing to the directory and using the time honoured incantation:

   ./configure
   make
   make install

or if you are using RedHat, Fedora, or something else that uses RPMs

   rpmbuild -tb spandsp-0.0.2.tar.gz

should build spandsp RPMs straight from the tar file. Then you just need to
install them.

Add the files rxfax.c, txfax.c and dtmftotext.c (the last one has nothing to
do with the fax machine, but my makefile patch expects it to be present) to
the apps directory of your * source tree. Then use Makefile.patch to patch
the makefile in the apps directory with:

   patch < Makefile.patch

Now if you rebuild and install * it should install these new apps.

OK, so how do you use them? Something like the following:

exten => 5678,1,rxfax(/home/steveu/testfax.tif)

will receive a fax if a fax machine dials 5678. The fax will be stored as the
/home/steveu/testfax.tif. Similarly:

exten => 6789,1,txfax(/home/steveu/testfax.tif)

will send the fax file /home/steveu/testfax.tif, when a fax machine dials 6789.

Regards,
Steve

