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