1 | .TH PSCATMAP 8 "19 August 1992" "Adobe Systems" |
---|
2 | \" Copyright (c) 1985,1987,1992 Adobe Systems Incorporated. All Rights Reserved. |
---|
3 | \" ATTN GOVERNMENT END USERS: See notice of rights in file XPSLIBDIRX/Notice |
---|
4 | \" RCSID: $Header: /afs/dev.mit.edu/source/repository/third/transcript/man/pscatmap.8p,v 1.1.1.1 1996-10-07 20:25:38 ghudson Exp $ |
---|
5 | .ds PS P\s-2OST\s+2S\s-2CRIPT\s+2 |
---|
6 | .SH NAME |
---|
7 | pscatmap\(embuild ptroff width tables from AFM files |
---|
8 | .SH "SYNOPSIS" |
---|
9 | .B XPSLIBDIRX/pscatmap |
---|
10 | .I mapfile |
---|
11 | .SH "DESCRIPTION" |
---|
12 | .I pscatmap |
---|
13 | builds correspondence tables and width tables so that |
---|
14 | documents produced with original |
---|
15 | [o]troff (1) |
---|
16 | can be translated into \*(PS language programs by |
---|
17 | pscat. |
---|
18 | .I pscatmap |
---|
19 | parses a human-readable mapping table and generates five output files\(em |
---|
20 | a |
---|
21 | family.ct |
---|
22 | file containing the character correspondence table for |
---|
23 | pscat, |
---|
24 | and |
---|
25 | four |
---|
26 | ft?? |
---|
27 | files, to be used as |
---|
28 | troff |
---|
29 | width tables. On most BSD systems, these files are C programs |
---|
30 | (ft\fIxx\fP.c) to be compiled into widths tables. |
---|
31 | On most System V systems, these files are the binary width tables |
---|
32 | themselves. Other systems may use ASCII font width tables. |
---|
33 | .PP |
---|
34 | The structure of the |
---|
35 | .map |
---|
36 | files is relatively easy to understand. If you want to create your own, |
---|
37 | the best thing to do is use an existing one as a template. Lines that |
---|
38 | begin with "%" are comments. Blank (empty) lines are ignored. |
---|
39 | Lines beginning with "@" are command lines. The following command |
---|
40 | lines are understood: |
---|
41 | .TP 1.3i |
---|
42 | .BI @FAMILYNAME " family" |
---|
43 | .br |
---|
44 | where |
---|
45 | .I family |
---|
46 | is a single token. This specifies the base name for the generated .ct file. |
---|
47 | .TP |
---|
48 | .BI @FACENAMES " rf if bf sf" |
---|
49 | .br |
---|
50 | where \fIrf, if, bf,\fR and |
---|
51 | .I sf, |
---|
52 | are the two-letter |
---|
53 | troff |
---|
54 | face codes for the Roman (font 1), Italic (font 2), Bold (font 3) |
---|
55 | and Symbol (font 4) fonts, respectively. |
---|
56 | .I pscatmap |
---|
57 | will generate files with the names: |
---|
58 | ft\fIrf\fP\|[.c], ft\fIif\fP\|[.c], ft\fIbf\fP\|[.c], ft\fIsf\fP\|[.c]. |
---|
59 | .TP |
---|
60 | .B @BEGINFONTS |
---|
61 | starts the section that identifies which fonts |
---|
62 | will be a part of this mapping and defines short names for these |
---|
63 | fonts (to be used in a later section of the map file). |
---|
64 | @BEGINFONTS is followed by a sequence of lines of the form: |
---|
65 | .RS |
---|
66 | \fBshortname\fP=\fIfontname\fP |
---|
67 | .RE |
---|
68 | .TP |
---|
69 | .B @ENDFONTS |
---|
70 | terminates this section. |
---|
71 | .TP |
---|
72 | .B @BEGINMAP |
---|
73 | begins the real correspondence description. |
---|
74 | What follows are a sequence of lines, each line describing |
---|
75 | a character action mapping. Each line represents one character. |
---|
76 | A line contains |
---|
77 | the troff character code, the troff face code (R, I, B, or S), |
---|
78 | the C/A/T character code, the character width, |
---|
79 | the character action, x and y offsets for position adjustments, |
---|
80 | the font and character code to map to, and a short |
---|
81 | text description of the font. |
---|
82 | .sp |
---|
83 | The best way to understand all this is to look at the map |
---|
84 | files already in the library and use them as examples. They have |
---|
85 | copious comments to help explain what they do. |
---|
86 | .TP |
---|
87 | .B @ENDMAP |
---|
88 | delimits the end of this section. |
---|
89 | .TP |
---|
90 | .BI @INCLUDE " file" |
---|
91 | reads commands from the named \fIfile\fP until it is exhausted, then |
---|
92 | switches back to the current input file. |
---|
93 | This command may appear in included files |
---|
94 | (that is, include files may be nested). |
---|
95 | This may be used to include the standard correspondence description, for |
---|
96 | example. |
---|
97 | .SH ENVIRONMENT |
---|
98 | .IP PSLIBDIR |
---|
99 | path name of a directory to use instead of |
---|
100 | XPSLIBDIRX for AFM files |
---|
101 | .SH FILES |
---|
102 | .TP 2i |
---|
103 | XPSLIBDIRX/*.afm |
---|
104 | font metrics files |
---|
105 | .TP |
---|
106 | \fIfamily\fP.map |
---|
107 | input mapping file |
---|
108 | .TP |
---|
109 | \fIfamily\fP.ct |
---|
110 | generated correspondence table |
---|
111 | .TP |
---|
112 | ft\fIxx\fP[.c] |
---|
113 | generated width files |
---|
114 | .SH "SEE ALSO" |
---|
115 | pscat(1), ptroff(1), transcript(1) |
---|
116 | .br |
---|
117 | BSD: troff(1). |
---|
118 | .br |
---|
119 | System V: otroff(1), \fIDocumenter's Workbench\fP. |
---|
120 | .SH AUTHOR |
---|
121 | Adobe Systems Incorporated |
---|
122 | .SH BUGS |
---|
123 | Mounting anything but a font named "S" in position 4 will cause |
---|
124 | troff |
---|
125 | to do unexpected things. |
---|
126 | troff |
---|
127 | really expects the symbol font to be named "S". |
---|
128 | Thus every font family defined |
---|
129 | should have identical symbol faces. |
---|
130 | You can specify some other face name in the |
---|
131 | .B @FACENAMES |
---|
132 | line for the fourth font, but don't ".fp" it in troff. |
---|
133 | .SH NOTES |
---|
134 | \*(PS is a registered trademark of Adobe Systems Incorporated. |
---|
135 | .br |
---|
136 | Documenter's Workbench is a trademark of AT&T Technologies. |
---|