manual/GNU_groff/original/man1/afmtodit.1

   1 .ig
   2 Copyright (C) 1989-2000, 2001 Free Software Foundation, Inc.
   3
   4 Permission is granted to make and distribute verbatim copies of
   5 this manual provided the copyright notice and this permission notice
   6 are preserved on all copies.
   7
   8 Permission is granted to copy and distribute modified versions of this
   9 manual under the conditions for verbatim copying, provided that the
  10 entire resulting derived work is distributed under the terms of a
  11 permission notice identical to this one.
  12
  13 Permission is granted to copy and distribute translations of this
  14 manual into another language, under the above conditions for modified
  15 versions, except that this permission notice may be included in
  16 translations approved by the Free Software Foundation instead of in
  17 the original English.
  18 ..
  19 .\" Like TP, but if specified indent is more than half
  20 .\" the current line-length - indent, use the default indent.
  21 .de Tp
  22 .ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
  23 .el .TP "\\$1"
  24 ..
  25 .TH AFMTODIT 1 "27 June 2001" "Groff Version 1.17.2"
  26 .SH NAME
  27 afmtodit \- create font files for use with groff \-Tps
  28 .SH SYNOPSIS
  29 .nr a \n(.j
  30 .ad l
  31 .nr i \n(.i
  32 .in +\w'\fBafmtodit 'u
  33 .ti \niu
  34 .B afmtodit
  35 .de OP
  36 .ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
  37 .el .RB "[\ " "\\$1" "\ ]"
  38 ..
  39 .OP \-nsv
  40 .OP \-d desc_file
  41 .OP \-e enc_file
  42 .OP \-i n
  43 .OP \-a n
  44 .I afm_file
  45 .I map_file
  46 .I font
  47 .br
  48 .ad \na
  49 .SH DESCRIPTION
  50 .B afmtodit
  51 creates a font file for use with groff and
  52 .BR grops .
  53 .B afmtodit
  54 is written in perl;
  55 you must have perl version 3 installed in order to run
  56 .BR afmtodit .
  57 .I afm_file
  58 is the AFM (Adobe Font Metric) file for the font.
  59 .I map_file
  60 is a file that says which groff character names map onto
  61 each PostScript character name;
  62 this file should contain a sequence of lines of the form
  63 .IP
  64 .I
  65 ps_char groff_char
  66 .LP
  67 where
  68 .I ps_char
  69 is the PostScript name of the character
  70 and
  71 .I groff_char
  72 is the groff name of the character (as used in the groff font file.)
  73 The same
  74 .I ps_char
  75 can occur multiple times in the file;
  76 each
  77 .I groff_char
  78 must occur at most once.
  79 .I font
  80 is the groff name of the font.
  81 If a PostScript character is in the encoding to be used for the font
  82 but is not mentioned in
  83 .I map_file
  84 then
  85 .B afmtodit
  86 will put it in the groff font file as an unnamed character,
  87 which can be accessed by the
  88 .B \eN
  89 escape sequence in
  90 .BR troff .
  91 The groff font file will be output to a file called
  92 .IR font .
  93 .LP
  94 If there is a downloadable font file for the font, it may be listed in
  95 the file
  96 .BR /usr/share/groff/1.17.2/font/devps/download ;
  97 see
  98 .BR grops (1).
  99 .LP
 100 If the
 101 .B \-i
 102 option is used,
 103 .B afmtodit
 104 will automatically generate an italic correction,
 105 a left italic correction and a subscript correction
 106 for each character
 107 (the significance of these parameters is explained in
 108 .BR groff_font (5));
 109 these parameters may be specified for individual characters by
 110 adding to the
 111 .I afm_file
 112 lines of the form:
 113 .IP
 114 .BI italicCorrection\  ps_char\ n
 115 .br
 116 .BI leftItalicCorrection\  ps_char\ n
 117 .br
 118 .BI subscriptCorrection\  ps_char\ n
 119 .LP
 120 where
 121 .I ps_char
 122 is the PostScript name of the character,
 123 and
 124 .I n
 125 is the desired value of the corresponding parameter in thousandths of an em.
 126 These parameters are normally needed only for italic (or oblique) fonts.
 127 .SH OPTIONS
 128 .TP
 129 .B \-v
 130 Print version.
 131 .TP
 132 .B \-n
 133 Don't output a
 134 .B ligatures
 135 command for this font.
 136 Use this with constant-width fonts.
 137 .TP
 138 .B \-s
 139 The font is special.
 140 The effect of this option is to add the
 141 .B special
 142 command to the font file.
 143 .TP
 144 .BI \-d desc_file
 145 The device description file is
 146 .I desc_file
 147 rather than the default
 148 .BR DESC .
 149 .TP
 150 .BI \-e enc_file
 151 The PostScript font should be reencoded to use the encoding described
 152 in enc_file.
 153 The format of
 154 .I enc_file
 155 is described in
 156 .BR grops (1).
 157 .TP
 158 .BI \-a n
 159 Use
 160 .I n
 161 as the slant parameter in the font file;
 162 this is used by groff in the positioning of accents.
 163 By default
 164 .B afmtodit
 165 uses the negative of the ItalicAngle specified in the afm file;
 166 with true italic fonts it is sometimes desirable to use
 167 a slant that is less than this.
 168 If you find that characters from an italic font have accents
 169 placed too far to the right over them,
 170 then use the
 171 .B \-a
 172 option to give the font a smaller slant.
 173 .TP
 174 .BI \-i n
 175 Generate an italic correction for each character so that
 176 the character's width plus the character's italic correction
 177 is equal to
 178 .I n
 179 thousandths of an em
 180 plus the amount by which the right edge of the character's bounding
 181 is to the right of the character's origin.
 182 If this would result in a negative italic correction, use a zero
 183 italic correction instead.
 184 .IP
 185 Also generate a subscript correction equal to the
 186 product of the tangent of the slant of the font and
 187 four fifths of the x-height of the font.
 188 If this would result in a subscript correction greater than the italic
 189 correction, use a subscript correction equal to the italic correction
 190 instead.
 191 .IP
 192 Also generate a left italic correction for each character
 193 equal to
 194 .I n
 195 thousandths of an em
 196 plus the amount by which the left edge of the character's bounding box
 197 is to the left of the character's origin.
 198 The left italic correction may be negative.
 199 .IP
 200 This option is normally needed only with italic (or oblique) fonts.
 201 The font files distributed with groff were created using an option of
 202 .B \-i50
 203 for italic fonts.
 204 .SH FILES
 205 .Tp \w'\fB/usr/share/groff/1.17.2/font/devps/download'u+2n
 206 .B /usr/share/groff/1.17.2/font/devps/DESC
 207 Device description file.
 208 .TP
 209 .BI /usr/share/groff/1.17.2/font/devps/ F
 210 Font description file for font
 211 .IR F .
 212 .TP
 213 .B /usr/share/groff/1.17.2/font/devps/download
 214 List of downloadable fonts.
 215 .TP
 216 .B /usr/share/groff/1.17.2/font/devps/text.enc
 217 Encoding used for text fonts.
 218 .TP
 219 .B /usr/share/groff/1.17.2/font/devps/generate/textmap
 220 Standard mapping.
 221 .SH "SEE ALSO"
 222 .BR groff (1),
 223 .BR grops (1),
 224 .BR groff_font (5),
 225 .BR perl (1)
 226 .
 227 .\" Local Variables:
 228 .\" mode: nroff
 229 .\" End: