/contrib/groff/src/utils/tfmtodit/tfmtodit.man

  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: