tfmtodit.man revision 256281
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