PSCATMAP

Section: Maintenance Commands (8)
Updated: 14 July 1987
Index Return to Main Contents

NAME

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.

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.

This document was created by man2html, using the manual pages.
Time: 00:58:36 GMT, September 26, 2024