The installation procedure is a little bit more complex compared with
those of other packages but you will find the required information in
the sections below.


1  configure
============

This is the simple part.  Typing

    % sh ./configure

should do it.  The configure script uses `/usr/local' as the default
installation prefix.  You can override this using the `--prefix' option
of the configure script.  Say, e.g.,

    % sh ./configure --prefix=/opt

if you wish to install everything under the `/opt' hierarchy.

The configure script prints its guesses to your terminal so that you
don't get too bored while waiting for it to finish.  Watch out for lines
looking like these:

    checking whether TeX is 8-bit transparent... no
    checking whether TeX supports the Cork encoding... yes

This tells you something about the character encoding supported by the
tex(1) command.  The next section will refer to the result of these
tests -- you are warned.


2  faxformat.tex
================

Sorry that you have to do this step by hand but I think this is the best
way to get a running setup.  The file `faxformat.tex' defines all macros
for typesetting fax messages.  You have to create this file because it
does not exist yet:

    % cp faxformat.tex-dist faxformat.tex

You don't have to change `faxformat.tex' if the defaults suite your
needs but I expect that you look at it because you don't know the
default behaviour yet.

You will find the commands

    \chardef\plain\z@
    \newlanguage\german

    \language\plain

at line 26.  Set the internal counter `\language' to your native
language.  You are in luck if you speak US english (plain TeX) or german
because everything is already done for these languages.  The rest of the
world has to (a) allocate its language with the `\newlanguage' command
and (b) extend all language dependent macros.  Good luck and please send
your extensions to me so that future releases will support your language
directly.  BTW: the default macros don't use language dependent macros
so that the actual value of `\language' doesn't matter at all.

The really important things happen from line 45 to 52.  Here is the code:

    \font\monospaced cmtt12
    \textfont\z@\monospaced
    \fam\z@\monospaced

    \setbox\strutbox\hbox{\vrule height 9\p@ depth 4\p@ width\z@}
    \normalbaselineskip 13\p@ \normalbaselines

    \input latin1-tex

This will use `cmtt12' (Computer Modern Typewriter Type at 12 point, a
standard TeX font) as the major text font.  The baselines are 13 point
apart.  This is less as you normally would expect from a 12 point font
but `cmtt12' is actually only 10 points high so that you have 3 points
of blank space between the lines.

The last line loads the character translations for your keyboard.  You
don't have to change this line if you use an ISO 8859-1 (alias Latin-1)
character encoding.

Your TeX supports the DC-Fonts if configure(1) answers `yes' to one of
these questions:

    checking whether TeX is 8-bit transparent... no
    checking whether TeX supports the Cork encoding... yes

You should exchange `cmtt12' with `dctt12' and `latin1-tex' with
`latin1-cork' in this case because the DC-Fonts looks much better for
european characters.  You don't need a character translation at all if
your TeX supports the Cork encoding directly.  Remove or comment out the
`\input' command to prevent trouble.

There are two examples at the end of `faxformat.tex' showing you common
formating tasks (a running headline and the inclusion of your favorite
logo in the footline).  Feel free to contact me if you need any other
specials.


3  config
=========

This file is the main configuration file for all fax tools.  Create it
from `config-dist' with the command

    % cp config-dist config

The format is described in the example configuration file `config-dist'
and there are example entries to make it more clear.


4  make
=======

There is not much left to do since configure(1) did most of the things
which have to be done.  Thus,

    # make install
    # make install-config

is all you have to say.  The `install' target does not overwrite your
hand-edited configuration files.  This will be done only with the
explicit `install-config' target.

You can selectively install or uninstall parts of this package with the
make targets `install', `install-exec' and `install-config', and their
`uninstall' counterparts.


5  Emacs
========

There's an Emacs mode for sending fax messages via faxpr(1).  Copy
`sendfax.el' into a directory of Emacs' load path and merge `emacs.el'
with your private initialization file `~/.emacs'.



Ralph Schleicher <rs@purple.IN-Ulm.DE>
