1.ig
2Copyright (C) 1989-2000, 2001, 2002 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.ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
20.el .ds tx TeX
21.\" Like TP, but if specified indent is more than half
22.\" the current line-length - indent, use the default indent.
23.de Tp
24.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
25.el .TP "\\$1"
26..
27.TH TFMTODIT @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
28.SH NAME
29tfmtodit \- create font files for use with groff \-Tdvi
30.SH SYNOPSIS
31.nr a \n(.j
32.ad l
33.nr i \n(.i
34.in +\w'\fBtfmtodit 'u
35.ti \niu
36.B tfmtodit
37.de OP
38.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
39.el .RB "[\ " "\\$1" "\ ]"
40..
41.OP \-sv
42.OP \-g gf_file
43.OP \-k skewchar
44.I tfm_file
45.I map_file
46.I font
47.br
48.ad \na
49.PP
50It is possible to have whitespace between a command line option and its
51parameter.
52.SH DESCRIPTION
53.B tfmtodit
54creates a font file for use with
55.B
56groff \-Tdvi\fR.
57.I tfm_file
58is the name of the \*(tx font metric file for the font.
59.I map_file
60is a file giving the groff names for characters in the font;
61this file should consist of a sequence of lines of the form:
62.IP
63.I
64n c1 c2 \fR.\|.\|.
65.LP
66where
67.I n
68is a decimal integer giving the position of the character in the font,
69and
70.IR c1 ,
71.IR c2 ,.\|.\|.
72are the groff names of the character.
73If a character has no groff names but exists in the tfm file,
74then it will be put in the groff font file as an unnamed character.
75.I font
76is the name of the groff font file.
77The groff font file is written to
78.IR font .
79.LP
80The
81.B \-s
82option should be given if the font is special
83(a font is
84.I special
85if
86.B troff
87should search it whenever
88a character is not found in the current font.)
89If the font is special,
90it should be listed in the
91.B fonts
92command in the DESC file;
93if it is not special, there is no need to list it, since
94.B troff
95can automatically mount it when it's first used.
96.LP
97To do a good job of math typesetting, groff requires
98font metric information not present in the tfm file.
99The reason for this is that \*(tx has separate math italic fonts
100whereas groff uses normal italic fonts for math.
101The additional information required by groff is given by the
102two arguments to the
103.B math_fit
104macro in the Metafont programs for the Computer Modern fonts.
105In a text font (a font for which
106.B math_fitting
107is false), Metafont normally ignores these two arguments.
108Metafont can be made to put this information in the gf file
109by loading the following definition after
110.B cmbase
111when creating
112.BR cm.base :
113.IP
114.nf
115.ft B
116def ignore_math_fit(expr left_adjustment,right_adjustment) =
117    special "adjustment";
118    numspecial left_adjustment*16/designsize;
119    numspecial right_adjustment*16/designsize;
120    enddef;
121.fi
122.ft R
123.LP
124For the EC font family, load the following definition after
125.B exbase
126(it is probably easiest to patch
127.B exbase.mf
128locally):
129.IP
130.nf
131.ft B
132def ignore_math_fit(expr left_adjustment,right_adjustment) =
133    ori_special "adjustment";
134    ori_numspecial left_adjustment*16/designsize;
135    ori_numspecial right_adjustment*16/designsize;
136    enddef;
137.fi
138.ft R
139.LP
140The gf file created using this modified
141.B cm.base
142or
143.B exbase
144should be specified with the
145.B \-g
146option.
147The
148.B \-g
149option should not be given for a font for which
150.B math_fitting
151is true.
152.SH OPTIONS
153.TP
154.B \-v
155Print the version number.
156.TP
157.B \-s
158The font is special.
159The effect of this option is to add the
160.B special
161command to the font file.
162.TP
163.BI \-k n
164The skewchar of this font is at position
165.IR n .
166.I n
167should be an integer;
168it may be given in decimal,
169or with a leading 
170.B 0
171in octal,
172or with a leading
173.B 0x
174in hexadecimal.
175The effect of this option is to ignore any kerns whose second component
176is the specified character.
177.TP
178.BI \-g gf_file
179.I gf_file
180is a gf file produced by Metafont containing special and numspecial
181commands giving additional font metric information.
182.SH FILES
183.Tp \w'\fB@FONTDIR@/devdvi/DESC'u+2n
184.B @FONTDIR@/devdvi/DESC
185Device description file.
186.TP
187.BI @FONTDIR@/devdvi/ F
188Font description file for font
189.IR F .
190.SH "SEE ALSO"
191.BR groff (@MAN1EXT@),
192.BR grodvi (@MAN1EXT@),
193.BR groff_font (@MAN5EXT@)
194.
195.\" Local Variables:
196.\" mode: nroff
197.\" End:
198