make.coverpg(1)
NAME
make.coverpg - create a fax coverpg on stdout
SYNOPSIS
make.coverpg [options] <pages> <sender-ID> <sender-NAME> <receiver-ID> <receiver-NAME> <date> <time>
DESCRIPTION
make.coverpg is called from faxspool(1) to generate a cover page for
the just-processed fax. It has to create a proper G3 file (e.g. via
pbm2g3(1) or hp2hig3(1) or ghostscript(1)) and output that on stdout.
If the program doesn't exist, or can't be executed, the fax simply
won't get a coverpage (so, if you don't want a fax coverpage, do not
install it...)
make.coverpg can put anything it wants on the page, but note that there
are certain legal requirements in certain countries about the contents
that *have* to be on the cover page, for example, the fax phone number
of the sender and the recepient, the number of pages, or similar
things.
make.coverpg gets the informations about the fax to be sent from the
command line, in the order listed above.
If the environment variable normal_res is set to something non-empty,
faxspool requests that make.coverpg creates a cover page in normal resolution (98 lpi). Default is fine resolution (196 lpi).
NO make.coverpg program is installed by default, since everyones needs
differ too wildly.
Some sample coverpage programs are provided in the mgetty source tree,
in the samples/ subdirectory (coverpg.pbm shows how to do it with "pbmtext|pbm2g3", coverpg.ps shows how I do it with ghostscript).
In this directory, you can also find two shell scripts (fax and
faxmemo) that will take advantage of one more esoteric feature of my
coverpage programs: if called with the option "-m <memo-file>", the
sample programs will put a text file "<memo-file>" on the cover page
(used for short notes or such). To make use of it, faxspool is called
with the option '-C "make.coverpg -m <memo-file>"' (the double quotes
are needed!).
OPTIONS
none
Example
A five-page fax sent from me to my second number could result in a call
like this:
make.coverpg 5 "+49-89-3243328" "Gert Doering" "3244814" "myself" "Sep
15 94" "22:10:00"
FILES
- /usr/lib/mgetty-fax/make.coverpg
- the program itself
SEE ALSO
faxspool(1), pbm2g3(1), ghostscript(1)
AUTHORS
- The idea behind make.coverpg is Copyright (C) 1993 by Gert Doering,
<gert@greenie.muc.de>, the implementation will most likely have
yours...