How to Build and Install the distribution of Xfax :
---------------------------------------------------

- Edit the Makefile, after appropriately setting the symbolic link to
  Makefile.linux or Makefile.solaris (should work also in other Unix
  environments with minor modifications). In particular, you should
  set there the appropriate installation and library directories,
  as well as the default editor and conversion tool ppm->xpm.
  You should also set the path allowing access to all utilities
  invoked from the scripts (including efix, efax, and optionally 
  tex, latex, pdftops if you wish to have tex, latex and pdf formats
  supported).
  
  In the original distribution, these parameters are set to

  BINDIR=/usr/local/bin
  FAXBASE=/opt/lib/xfax
  EDITOR=emacs
  CONVERT=ppmtoxpm
  FAXPATH="${FAXBASE}/bin:/bin:/usr/bin:/usr/bin/X11:/usr/local/bin:/usr/lib/teTeX/bin"

- If you don't have the Xforms library, download it from
    ftp://einstein.phys.uwm.edu/pub/xforms
    ftp://ftp.cs.ruu.nl/pub/XFORMS  (Primary mirror site)
  It is required to compile xfax, but not needed to run the binary
  static version.

- check that the symbolic link "forms.h" actually points to where it
  should point to

- Xfax optionally makes use of the "convert" utility from the ImageMagick 
  package, which can be downloaded from
    ftp://ftp.wizards.dupont.com:/pub/ImageMagick/
  This utility can be replaced by other equivalent conversion tools
  if not available on your system (e.g., the g3toxpm script works with
  ppmtoxpm instead of convert). However, the main advantage of the
  convert utility is that it can handle as well a very large number 
  of different image file formats. This is needed in the script anytog3
  to process various image files; convert is otherwise not needed if
  you intend to use only ASCII, PostScript, PDF or TeX/LaTeX files.

- Edit the "local.cfg" file according to the instructions given there,
  especially:
  * DEFAULTFROM="+99 1234567890"  fax number of your institution
  * DEFAULTHDRADDR="....."        abbreviated address of your institution
  * SPOOLDIR=/var/spool/fax       spooling directory
  * DEV=cua2                      appropriate modem device

- Build the executable, just by using "make" (dynamically linked executable)
  or "make xfax.static" (statically linked executable)

- Check the PRINTCMD in the faxprint script. We recommend that printing
  be made through "ghostview" or "gv". In this way, the user can check
  and select pages before actually printing. Note that the printout is
  Postscript, so the printcmd should be able to print Postscript files.
  "lpr" is for Linux, "lp" or a filter with ghostscript ("lpps") that
  drives lp for SYSV.

- Install the package as root by typing "make install".

- Log in as a non privileged user, run xfax, and check that everything
  works OK. On the first run, it is required to fill your private data
  with the "Set User info" option from the Options menu.


Kees Lemmens, Jean-Pierre Demailly
