| 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.2 1996-10-14 05:09:44 ghudson Exp $ |
|---|
| 5 | .ds PS P\s-2OST\s+2S\s-2CRIPT\s+2 |
|---|
| 6 | .SH NAME |
|---|
| 7 | pscatmap \- build 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), troff(1) |
|---|
| 116 | .SH AUTHOR |
|---|
| 117 | Adobe Systems Incorporated |
|---|
| 118 | .SH BUGS |
|---|
| 119 | Mounting anything but a font named "S" in position 4 will cause |
|---|
| 120 | troff |
|---|
| 121 | to do unexpected things. |
|---|
| 122 | troff |
|---|
| 123 | really expects the symbol font to be named "S". |
|---|
| 124 | Thus every font family defined |
|---|
| 125 | should have identical symbol faces. |
|---|
| 126 | You can specify some other face name in the |
|---|
| 127 | .B @FACENAMES |
|---|
| 128 | line for the fourth font, but don't ".fp" it in troff. |
|---|
| 129 | .SH NOTES |
|---|
| 130 | \*(PS is a registered trademark of Adobe Systems Incorporated. |
|---|
| 131 | .br |
|---|
| 132 | Documenter's Workbench is a trademark of AT&T Technologies. |
|---|
