BSD 4_3_Net_2 release
[unix-history] / usr / src / usr.bin / groff / man / addftinfo.man
CommitLineData
00f22e75
C
1.\" -*- nroff -*-
2.TH ADDFTINFO @MAN1EXT@ "30 April 1990" "Groff Version @VERSION@"
3.SH NAME
4addftinfo \- add information to troff font files for use with groff
5.SH SYNOPSIS
6.B addftinfo
7[
8.BI \- param\ value\fR.\|.\|.
9]
10.I res
11.I unitwidth
12.I font
13.SH DESCRIPTION
14.B addftinfo
15reads a troff font file
16and adds some additional font-metric information
17that is used by the groff system.
18The font file with the information added is written on the
19standard output.
20The information added is guessed using
21some parametric information about the font
22and assumptions
23about the traditional troff names for characters.
24The main information added is the heights and depths of characters.
25The
26.I res
27and
28.I unitwidth
29arguments should be the same as the corresponding parameters
30in the DESC file;
31.I font
32is the name of the file describing the font;
33if
34.I font
35ends with
36.B I
37the font will be assumed to be italic.
38.SH OPTIONS
39Each of the options changes one of the parameters that is used
40to derive the heights and depths.
41Like the existing quantities in the font
42file, each
43.I value
44is in
45.RI inches/ res
46for a font whose point size is
47.IR unitwidth .
48.I param
49must be one of:
50.TP
51.B x-height
52The height of lowercase letters without ascenders such as x.
53.TP
54.B fig-height
55The height of figures (digits).
56.TP
57.B asc-height
58The height of characters with ascenders, such as b, d or l.
59.TP
60.B body-height
61The height of characters such as parentheses.
62.TP
63.B cap-height
64The height of uppercase letters such as A.
65.TP
66.B comma-depth
67The depth of a comma.
68.TP
69.B desc-depth
70The depth of characters with descenders, such as p,q, or y.
71.TP
72.B body-depth
73The depth of characters such as parentheses.
74.LP
75.B addftinfo
76makes no attempt to use the specified parameters to guess
77the unspecified parameters.
78If a parameter is not specified the default will be used.
79The defaults are chosen to have the reasonable values for
80a Times font.
81.SH "SEE ALSO"
82.BR font (5)
83.BR groff_font (@MAN5EXT@),
84.BR groff (@MAN1EXT@),
85.I "Groff Character Names"