Substitution Patterns and The Top-of-Page Banners

The Banners identified in a style specify the text that will appear at the top of every page faxed by Faximum. You may specify one or two lines of text and the text may contain any ASCII character as well as the following substitution patterns.

$p - current page number
$t - total page count for this fax
$r - name of destination recipient
$c - name of destination company
$s - name of sender
%c - current date and time

The $r, $s, and $c patterns may include a number specifying the field width. The string is truncated or right-padded to fit this specification. For example, $20s indicates that the name of the sender is to occupy 20 character positions (only).

Examples

The following banner:


Faximum Software Inc.  +1 (604) 926-8182  %c  $p/$t

prints the company name (Faximum Software Inc.), fax number (+1 (604) 926-8182), time and date (%c), and page value ($p/$t) at the top of the page. Here is an example output on the first page of a two page fax:


Faximum Software Inc.  +1 (604) 926-8182  Fri Sep 18 9:21:52 1992  1/2

Note that all standard date and time substitution patterns are also supported. See the man page for strftime for a list. For example:


Faximum Software Inc.  %X %x $p/$t

produces the following example output:


Faximum Software Inc. 9:21:52 09/18/92  1/2

(The exact representation of the time and date will depend on the locale your machine is configured to use.)

If you wanted the top-of-page banner to include information about the sender and recipient you could use:


To: $r, $c  From: $s

If your name as "Jane Doe" and you were sending to "John Ho" of "ACME Construction" this banner would appear as:


To: John Ho, ACME Construction   From: Jane Doe

Typical uses of the banners are as follows:

Banner1 could identify the company, date, time and page (as shown above).
Banner2 could identify the sender and recipient of the fax (as shown above).