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

       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...


Man(1) output converted with man2html