./_Man_Local_html/html1/faxcover.1.html

Manual page for FAXCOVER(1)

faxcover - generate a cover page for an outgoing facsimile

SYNOPSIS

faxcover [ -t to-name ] [ -l to-location ] [ -x to-company ] [ -v to-voice-number ] [ -c comments ] [ -r regarding ] [ -p page-count ] [ -s pagesize-name ] [ -C template-file ] -f from-name -n fax-number

DESCRIPTION

Faxcover generates a PostScript® cover page document on the standard output. The cover page fills the entire area of a default page and is created according to the information supplied on the command line and a cover sheet template file.

Faxcover is normally invoked by the sendfax.1 program to generate the cover page for each outgoing facsmile.

Faxcover works by creating a PostScript dictionary that contains definitions for the variable information that is to be placed on the facsimile cover page. Specifically, a dictionary with the following symbols are defined:

Symbol	Description	Symbol	Description
to	destination person	from	sending person
to-company	destination company	from-company	sender's company
to-location	destination geographic location	from-location	sender geographic location
to-voice-number	person's voice phone number	from-voice-number	sender's voice phone number
to-fax-number	destination fax phone number	from-fax-number	sender's fax phone number
regarding	Re: subject	commentsX	X'th line of comments
page-count	# pages other than cover page	todays-date	current date and time
pageWidth	page width in millimeters	pageLength	page length in millimeters

If the comments string is longer than 35 characters, it is broken, on word boundaries, into multiple PostScript strings. Each line is defined as commentsX where X is the line number; e.g. comments2 for the second line of comments.

If information is unavailable for an item, the associated symbol is defined to be a null string.

Following the definition prologue, a cover sheet template file is copied. This file is expected to be a PostScript program that uses the supplied definitions to generate a cover page. The template must include a showpage operator to cause the page to be imaged. The above definitions will be defined in the current dictionary. A trailing end operator is supplied by faxcover, so any manipulation of the dictionary stack should leave the current dictionary on the top of the stack on completion.

The default template file is named faxcover.ps; this can be overridden with the -C option by specifying a file in the FAXCOVER environment variable. If the file name is not an absolute path, then faxcover looks first for this file in the home directory of the sender. If no such file is present, then it looks in the library directory where the FlexFAX client application data are installed. If no template file is located, faxcover will terminate without generating a cover page.

DIAGNOSTICS

Complaints about not being able to locate a template file.

FILES

~/.faxdb personal fax number database
${LIBDATA}/faxcover.ps default cover page template
${LIBDATA}/pagesizes page size database

BUGS