make.coverpg(1) 					       mgetty+sendfax manual						   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 con-
       tents 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 simi-
       lar 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 cover-
       page 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+sendfax/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...

greenie 							     27 Oct 93							   make.coverpg(1)