PSCATMAP(8)PSCATMAP(8)NAMEpscatmap - build ptroff width tables POSTSCRIPT fonts
SYNOPSIS
/usr/lib/transcript/troff.font/pscatmap mapfile
DESCRIPTIONpscatmap builds correspondence tables and width tables so that
documents produced with original [o]troff(1) can be translated into
POSTSCRIPT programs by pscat. pscatmap parses a human-readable mapping
table and generates five output files - a family.ct file, containing
the character correspondence table for pscat, and four ft?? files, to
be used as troff width tables. On 4.2bsd systems, these files are C
programs (ftxx.c) to be compiled into widths tables. On System V
systems, these files are the binary width tables themselves.
The structure of the .map files is relatively easy to understand. 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 command lines are understood:
@FAMILYNAME family
where family is a single token. This specifies the base
name for the generated .ct file.
@FACENAMES rf if bf sf
where rf, if, bf, and sf, are the two-letter troff face
codes for the Roman (font 1), Italic (font 2), Bold (font
3) and Symbol (font 4) fonts, respectively. pscatmap will
generate files with the names: ftrf[.c], ftif[.c],
ftbf[.c], ftsf[.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=Font-Name
@ENDFONTS terminates this section.
@BEGINMAP begins the real correspondence description. What follows
are a sequence of lines, each line describing a character
action mapping. Each line represents one character. A
line contains: 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.
@INCLUDE file
reads commands from the named file until it is exhausted,
then switches back to the current input file. This
command may appear in included files (that is, include
files may be nested). This may be used to include the
standard correspondence description, which is identical in
most Adobe fonts.
ENVIRONMENT
PSLIBDIR path name of a directory to use instead of /usr/lib/transcript
for AFM files.
FILES
/usr/lib/transcript/*.afm
font metrics files.
family.map input mapping file.
family.ct generated correspondence table.
ftxx[.c] generated width files.
SEE ALSOpscat(1), ptroff(1), transcript(1).
4.2bsd: troff(1).
System V: otroff(1), Documenter's Workbench.
AUTHOR
Adobe Systems Incorporated
DIAGNOSTICS
Lots, should be self explanatory.
BUGS
Mounting anything but a font named `S' in position 4 will cause troff
to do unexpected things. troff really expects the symbol font to be
named `S'. Thus every font family defined should have identical symbol
faces. You can specify some other face name in the @FACENAMES line for
the fourth font, but don't ``.fp'' it in troff.
NOTES
POSTSCRIPT is a registered trademark of Adobe Systems Incorporated.
Documenter's Workbench is a trademark of AT&T Technologies.
Adobe Systems 14 July 1987 PSCATMAP(8)
