1.ig
2Copyright (C) 1989-2000, 2001 Free Software Foundation, Inc.
3
4Permission is granted to make and distribute verbatim copies of
5this manual provided the copyright notice and this permission notice
6are preserved on all copies.
7
8Permission is granted to copy and distribute modified versions of this
9manual under the conditions for verbatim copying, provided that the
10entire resulting derived work is distributed under the terms of a
11permission notice identical to this one.
12
13Permission is granted to copy and distribute translations of this
14manual into another language, under the above conditions for modified
15versions, except that this permission notice may be included in
16translations approved by the Free Software Foundation instead of in
17the original English.
18..
19.TH ADDFTINFO @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
20.SH NAME
21addftinfo \- add information to troff font files for use with groff
22.SH SYNOPSIS
23.B addftinfo
24[
25.B \-v
26]
27[
28.BI \- param\ value\fR.\|.\|.
29]
30.I res
31.I unitwidth
32.I font
33.SH DESCRIPTION
34.B addftinfo
35reads a troff font file
36and adds some additional font-metric information
37that is used by the groff system.
38The font file with the information added is written on the
39standard output.
40The information added is guessed using 
41some parametric information about the font
42and assumptions
43about the traditional troff names for characters.
44The main information added is the heights and depths of characters.
45The
46.I res
47and
48.I unitwidth
49arguments should be the same as the corresponding parameters
50in the DESC file;
51.I font
52is the name of the file describing the font;
53if
54.I font
55ends with
56.B I
57the font will be assumed to be italic.
58.SH OPTIONS
59.B \-v
60prints the version number.
61.LP
62All other options changes one of the parameters that is used
63to derive the heights and depths.
64Like the existing quantities in the font
65file, each
66.I value
67is in
68.RI inches/ res
69for a font whose point size is
70.IR unitwidth .
71.I param
72must be one of:
73.TP
74.B x-height
75The height of lowercase letters without ascenders such as x.
76.TP
77.B fig-height
78The height of figures (digits).
79.TP
80.B asc-height
81The height of characters with ascenders, such as b, d or l.
82.TP
83.B body-height
84The height of characters such as parentheses.
85.TP
86.B cap-height
87The height of uppercase letters such as A.
88.TP
89.B comma-depth
90The depth of a comma.
91.TP
92.B desc-depth
93The depth of characters with descenders, such as p,q, or y.
94.TP
95.B body-depth
96The depth of characters such as parentheses.
97.LP
98.B addftinfo
99makes no attempt to use the specified parameters to guess
100the unspecified parameters.
101If a parameter is not specified the default will be used.
102The defaults are chosen to have the reasonable values for
103a Times font.
104.SH "SEE ALSO"
105.BR groff_font (@MAN5EXT@),
106.BR groff (@MAN1EXT@),
107.BR groff_char (@MAN7EXT@)
108.
109.\" Local Variables:
110.\" mode: nroff
111.\" End:
112