4.3BSD-UWisc/man/cat8/pscatmap.8
PSCATMAP(8) UNIX Programmer's Manual PSCATMAP(8)
NAME
pscatmap - build ptroff width tables POSTSCRIPT fonts
SYNOPSIS
/usr/misc/lib/ps/pscatmap _m_a_p_f_i_l_e
DESCRIPTION
_p_s_c_a_t_m_a_p builds correspondence tables and width tables so
that documents produced with original [_o]_t_r_o_f_f(1) can be
translated into POSTSCRIPT programs by _p_s_c_a_t. _p_s_c_a_t_m_a_p
parses a human-readable mapping table and generates five
output files - a _f_a_m_i_l_y.ct file, containing the character
correspondence table for _p_s_c_a_t, and four _f_t?? files, to be
used as _t_r_o_f_f width tables. On 4.2bsd systems, these files
are C programs (ft_x_x.c) to be compiled into widths tables.
On System V systems, these files are the binary width tables
themselves.
The user must create a _f_a_m_i_l_y.head file containing ``.fp''
commands to preload appropriate fonts for [_o]_t_r_o_f_f.
The structure of the ._m_a_p files is relatively easy to under-
stand. If you want to create your own, the best thing to do
is use an existing one as a template. Lines that begin with
``%'' are comments. Blank (empty) lines are ignored. Lines
beginning with ``@'' are command lines. The following com-
mand lines are understood:
@FAMILYNAME _f_a_m_i_l_y
where _f_a_m_i_l_y is a single token. This specifies
the base name for the generated .ct file.
@FACENAMES _r_f _i_f _b_f _s_f
where _r_f, _i_f, _b_f, and _s_f, are the two-letter
_t_r_o_f_f face codes for the Roman (font 1), Italic
(font 2), Bold (font 3) and Symbol (font 4)
fonts, respectively. _p_s_c_a_t_m_a_p will generate
files with the names: ft_r_f[.c], ft_i_f[.c],
ft_b_f[.c], ft_s_f[.c].
@BEGINFONTS starts the section which identifies which
POSTSCRIPT fonts will be a part of this mapping
and defines short names for these fonts (to be
used in a later section of the map file).
@BEGINFONTS is followed by a sequence of lines
of the form:
shortname=_F_o_n_t-_N_a_m_e
@ENDFONTS terminates this section.
@BEGINMAP begins the real correspondence description.
What follows are a sequence of lines, each line
Printed 1/10/87 12 Nov 1985 1
PSCATMAP(8) UNIX Programmer's Manual PSCATMAP(8)
describing a character action mapping. Each
line represents one character. A line con-
tains: the troff character code, the troff face
code (R, I, B, or S), the C/A/T character code,
the character width, the character action, x
and y offsets for position adjustments, the
POSTSCRIPT font and POSTSCRIPT character code
to map to, and a short text description of the
font.
The best way to understand all this is to look
at the map files already in the library and use
them as examples. They have copious comments
to help explain what they do.
@ENDMAP delimits the end of this section.
ENVIRONMENT
PSLIBDIR path name of a directory to use instead of
/usr/misc/lib/ps for AFM files.
FILES
/usr/misc/lib/ps/*.afm
font metrics files.
_f_a_m_i_l_y.map input mapping file.
_f_a_m_i_l_y.ct generated correspondence table.
ft_x_x[.c] generated width files.
SEE ALSO
pscat(1), ptroff(1).
4.2bsd: troff(1).
System V: otroff(1), _D_o_c_u_m_e_n_t_e_r'_s _W_o_r_k_b_e_n_c_h.
AUTHOR
Adobe Systems Incorporated
DIAGNOSTICS
Lots, should be self explanatory.
BUGS
Mounting anything but a font named `S' in position 4 will
cause _t_r_o_f_f to do unexpected things. _t_r_o_f_f really expects
the symbol font to me named `S'. Thus every font family
defined should have identical symbol faces. For this rea-
son, the text and symbol descriptions of the map files have
been segmented. You can specify some other face name in the
@FACENAMES line for the fourth font, but don't ``.fp'' it in
troff.
Printed 1/10/87 12 Nov 1985 2
PSCATMAP(8) UNIX Programmer's Manual PSCATMAP(8)
NOTES
POSTSCRIPT is a trademark of Adobe Systems Incorporated.
Documenter's Workbench is a trademark of AT&T Technologies.
Printed 1/10/87 12 Nov 1985 3