Substitutions

Substitutions

Substitutions are allowed in the Header, the Footer, and the Destination File. A substitution is the percent (`%') character followed by another character that has a special meaning. There are certain substitutions that are only valid in headers and footers: ``%|'', ``%n'', and ``%(''.

The substitution ``%|'' allows headers and footers to be split into three sections: left, center, and right. Before the first ``%|'', text is left justified with respect to the left margin. After the first ``%|'', text is centered between the left and right margins. After the second ``%|'', text is right justified with respect to the right margin.

Newlines, written with the substitution ``%n'', cause the succeeding text to be printed one line below the current text in the current section. For example, a header of ``%f%|%v%n%p'' would have the file name left justified, the view name centered, and the current page number centered below the view name.

Fonts may be specified using the substitution ``%('' followed by the font name, font size, and right parenthesis (`)'), with no intervening whitespace. The font name must be a name known to PostScript [X] or Windows [MS]. For example, ``%(Times-Roman10)'' specifies 10-point Times-Roman. Within a header or footer, a font specification remains in effect until another font specification overrides it, but the specification does not carry over from header to footer.

X	If no font is specified, a default font is taken from the prolog. There is a limit of 8 different font specifications that can be used for the header and footer (the same font specification can be used in different places as many times as needed).
MS	If no font is specified, a default font is taken.

The following is a complete list of available special characters, each of which must be preceded by a percent (`%') character:

% Print the percent character
| Move to the next section (there are three sections: left, center, and right)
b The name of the buffer
d The current date and time
f The base name of the file
F The full pathname of the file
m The date and time the file was last modified
n Print a newline (allowing multi-line headers and footers)
p The current page number
t The total number of pages in the entire document
u The current user name
v The name of the view
( Start a new font. The font must be specified immediately following the left parenthesis and must end in a right parenthesis.

Any other character following a percent (`%') character is ignored.