1AFMTODIT(1)                 General Commands Manual                AFMTODIT(1)
2
3
4

NAME

6       afmtodit - create font files for use with groff -Tps and -Tpdf
7

SYNOPSIS

9       afmtodit [ -ckmnsvx ] [ -a n ] [ -d desc_file ] [ -e enc_file ]
10                [ -f internal_name ] [ -i n ] [ -o out_file ] afm_file
11                map_file font
12
13       The  whitespace  between  a  command  line  option  and its argument is
14       optional.
15

DESCRIPTION

17       afmtodit creates a font file for use with  groff,  grops,  and  gropdf.
18       afmtodit  is written in perl; you must have perl version 5.004 or newer
19       installed in order to run afmtodit.
20
21       afm_file is the AFM (Adobe Font Metric) file for the font.
22
23       map_file is a file that says which groff character names map onto  each
24       PostScript character name; this file should contain a sequence of lines
25       of the form
26
27              ps_char groff_char
28
29       where ps_char is the PostScript name of the character and groff_char is
30       the  groff name of the character (as used in the groff font file).  The
31       same ps_char can occur multiple times in the file; each groff_char must
32       occur at most once.  Lines starting with # and blank lines are ignored.
33       If the file isn't found in the current directory, it is searched in the
34       ‘devps/generate’ subdirectory of the default font directory.
35
36       If  a  PostScript character is not mentioned in map_file, and a generic
37       groff glyph name can't be deduced using  the  Adobe  Glyph  List  (AGL,
38       built  into afmtodit), then afmtodit puts the PostScript character into
39       the groff font file as an unnamed character which can only be  accessed
40       by  the  \N  escape sequence in troff.  In particular, this is true for
41       glyph variants like ‘foo.bar’; all glyph names containing one  or  more
42       periods are mapped to unnamed entities.  If option -e is not specified,
43       the encoding defined in the AFM file (i.e., entries  with  non-negative
44       character  codes)  is used.  Please refer to section ‘Using Symbols’ in
45       the groff info file which describes how  groff  glyph  names  are  con‐
46       structed.
47
48       Characters  not encoded in the AFM file (i.e., entries which have -1 as
49       the character code) are still available in groff; they get glyph  index
50       values  greater  than  255  (or greater than the biggest character code
51       used in the AFM file in the unlikely case that it is greater than  255)
52       in  the  groff  font file.  Glyph indices of unencoded characters don't
53       have a specific order; it is best to access them with glyph names only.
54
55       The groff font file will be output to a file called font, unless the -o
56       option is used.
57
58       If  there is a downloadable font file for the font, it may be listed in
59       the file /usr/share/groff/1.22.3/font/devps/download; see grops(1).
60
61       If the -i option is  used,  afmtodit  will  automatically  generate  an
62       italic  correction, a left italic correction and a subscript correction
63       for each character (the significance of these parameters  is  explained
64       in  groff_font(5));  these  parameters  may be specified for individual
65       characters by adding to the afm_file lines of the form:
66
67              italicCorrection ps_char n
68              leftItalicCorrection ps_char n
69              subscriptCorrection ps_char n
70
71       where ps_char is the PostScript name of the character,  and  n  is  the
72       desired  value  of the corresponding parameter in thousandths of an em.
73       These parameters are normally  needed  only  for  italic  (or  oblique)
74       fonts.
75

OPTIONS

77       -an    Use  n  as the slant parameter in the font file; this is used by
78              groff in the positioning of accents.  By default  afmtodit  uses
79              the  negative of the ItalicAngle specified in the afm file; with
80              true italic fonts it is sometimes desirable to use a slant  that
81              is  less  than this.  If you find that characters from an italic
82              font have accents placed too far to the right  over  them,  then
83              use the -a option to give the font a smaller slant.
84
85       -c     Include  comments  in  the font file in order to identify the PS
86              font.
87
88       -ddesc_file
89              The device description file is desc_file rather than the default
90              DESC.   If not found in the current directory, the ‘devps subdi‐
91              rectory of the default font directory is searched (this is  true
92              for  both  the  default device description file and a file given
93              with option -d).
94
95       -eenc_file
96              The PostScript font should be  reencoded  to  use  the  encoding
97              described  in  enc_file.  The format of enc_file is described in
98              grops(1).  If not found in the current  directory,  the  ‘devps’
99              subdirectory of the default font directory is searched.
100
101       -fname The internal name of the groff font is set to name.
102
103       -in    Generate  an  italic  correction  for each character so that the
104              character's width plus  the  character's  italic  correction  is
105              equal  to  n  thousandths  of an em plus the amount by which the
106              right edge of the character's bounding box is to  the  right  of
107              the  character's  origin.   If  this  would result in a negative
108              italic correction, use a zero italic correction instead.
109
110              Also generate a subscript correction equal to the product of the
111              tangent of the slant of the font and four fifths of the x-height
112              of the font.  If this would result  in  a  subscript  correction
113              greater  than  the italic correction, use a subscript correction
114              equal to the italic correction instead.
115
116              Also generate a left italic correction for each character  equal
117              to n thousandths of an em plus the amount by which the left edge
118              of the character's bounding box is to the left  of  the  charac‐
119              ter's origin.  The left italic correction may be negative unless
120              option -m is given.
121
122              This option is normally needed only  with  italic  (or  oblique)
123              fonts.  The font files distributed with groff were created using
124              an option of -i50 for italic fonts.
125
126       -oout_file
127              The output file is out_file instead of font.
128
129       -k     Omit any kerning data from the groff font.  This should be  used
130              only for mono-spaced fonts.
131
132       -m     Prevent  negative  left  italic  correction  values.  Roman font
133              files distributed with groff were created with -i0 -m to improve
134              spacing with eqn(1).
135
136       -n     Don't  output  a ligatures command for this font.  Use this with
137              constant-width fonts.
138
139       -s     The font is special.  The effect of this option is  to  add  the
140              special command to the font file.
141
142       -v     Print version.
143
144       -x     Don't use the built-in Adobe Glyph List.
145

FILES

147       /usr/share/groff/1.22.3/font/devps/DESC
148              Device description file.
149
150       /usr/share/groff/1.22.3/font/devps/F
151              Font description file for font F.
152
153       /usr/share/groff/1.22.3/font/devps/download
154              List of downloadable fonts.
155
156       /usr/share/groff/1.22.3/font/devps/text.enc
157              Encoding used for text fonts.
158
159       /usr/share/groff/1.22.3/font/devps/generate/textmap
160              Standard mapping.
161

SEE ALSO

163       groff(1), grops(1), groff_font(5), perl(1)
164
165       The groff info file, section ‘Using Symbols’.
166

COPYING

168       Copyright © 1989-2014 Free Software Foundation, Inc.
169
170       Permission  is  granted  to make and distribute verbatim copies of this
171       manual provided the copyright notice and  this  permission  notice  are
172       preserved on all copies.
173
174       Permission  is granted to copy and distribute modified versions of this
175       manual under the conditions for verbatim  copying,  provided  that  the
176       entire  resulting derived work is distributed under the terms of a per‐
177       mission notice identical to this one.
178
179       Permission is granted to copy and distribute translations of this  man‐
180       ual into another language, under the above conditions for modified ver‐
181       sions, except that this permission notice may be included  in  transla‐
182       tions approved by the Free Software Foundation instead of in the origi‐
183       nal English.
184
185
186
187Groff Version 1.22.3            4 November 2014                    AFMTODIT(1)
Impressum