tfmtodit.man revision 75584 
1.ig \"-*- nroff -*-
2Copyright (C) 1989-2000 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
124The gf file created using this modified
125.B cm.base
126should be specified with the
127.B \-g
128option.
129The
130.B \-g
131option should not be given for a font for which
132.B math_fitting
133is true.
134.SH OPTIONS
135.TP
136.B \-v
137Print the version number.
138.TP
139.B \-s
140The font is special.
141The effect of this option is to add the
142.B special
143command to the font file.
144.TP
145.BI \-k n
146The skewchar of this font is at position
147.IR n .
148.I n
149should be an integer;
150it may be given in decimal,
151or with a leading 
152.B 0
153in octal,
154or with a leading
155.B 0x
156in hexadecimal.
157The effect of this option is to ignore any kerns whose second component
158is the specified character.
159.TP
160.BI \-g gf_file
161.I gf_file
162is a gf file produced by Metafont containing special and numspecial
163commands giving additional font metric information.
164.SH FILES
165.Tp \w'\fB@FONTDIR@/devdvi/DESC'u+2n
166.B @FONTDIR@/devdvi/DESC
167Device description file.
168.TP
169.BI @FONTDIR@/devdvi/ F
170Font description file for font
171.IR F .
172.SH "SEE ALSO"
173.BR groff (@MAN1EXT@),
174.BR grodvi (@MAN1EXT@),
175.BR groff_font (@MAN5EXT@)
176