Manual page for PSCATMAP(8)
pscatmap - build ptroff width tables POSTSCRIPT fonts
SYNOPSIS
/usr/lib/transcript/troff.font/pscatmap
mapfile
DESCRIPTION
pscatmap
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 ALSO
pscat(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.
Created by unroff & hp-tools.
© somebody (See intro for details). All Rights Reserved.
Last modified 11/5/97
