tfmtodit.man revision 104862
179543Sru.ig 2104862SruCopyright (C) 1989-2000, 2001, 2002 Free Software Foundation, Inc. 375584Sru 475584SruPermission is granted to make and distribute verbatim copies of 575584Sruthis manual provided the copyright notice and this permission notice 675584Sruare preserved on all copies. 775584Sru 875584SruPermission is granted to copy and distribute modified versions of this 975584Srumanual under the conditions for verbatim copying, provided that the 1075584Sruentire resulting derived work is distributed under the terms of a 1175584Srupermission notice identical to this one. 1275584Sru 1375584SruPermission is granted to copy and distribute translations of this 1475584Srumanual into another language, under the above conditions for modified 1575584Sruversions, except that this permission notice may be included in 1675584Srutranslations approved by the Free Software Foundation instead of in 1775584Sruthe original English. 1875584Sru.. 1975584Sru.ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X 2075584Sru.el .ds tx TeX 2175584Sru.\" Like TP, but if specified indent is more than half 2275584Sru.\" the current line-length - indent, use the default indent. 2375584Sru.de Tp 2475584Sru.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP 2575584Sru.el .TP "\\$1" 2675584Sru.. 2775584Sru.TH TFMTODIT @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" 2875584Sru.SH NAME 2975584Srutfmtodit \- create font files for use with groff \-Tdvi 3075584Sru.SH SYNOPSIS 3175584Sru.nr a \n(.j 3275584Sru.ad l 3375584Sru.nr i \n(.i 3475584Sru.in +\w'\fBtfmtodit 'u 3575584Sru.ti \niu 3675584Sru.B tfmtodit 3775584Sru.de OP 3875584Sru.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]" 3975584Sru.el .RB "[\ " "\\$1" "\ ]" 4075584Sru.. 4175584Sru.OP \-sv 4275584Sru.OP \-g gf_file 4375584Sru.OP \-k skewchar 4475584Sru.I tfm_file 4575584Sru.I map_file 4675584Sru.I font 4775584Sru.br 4875584Sru.ad \na 4975584Sru.PP 5075584SruIt is possible to have whitespace between a command line option and its 5175584Sruparameter. 5275584Sru.SH DESCRIPTION 5375584Sru.B tfmtodit 5475584Srucreates a font file for use with 5575584Sru.B 5675584Srugroff \-Tdvi\fR. 5775584Sru.I tfm_file 5875584Sruis the name of the \*(tx font metric file for the font. 5975584Sru.I map_file 6075584Sruis a file giving the groff names for characters in the font; 6175584Sruthis file should consist of a sequence of lines of the form: 6275584Sru.IP 6375584Sru.I 6475584Srun c1 c2 \fR.\|.\|. 6575584Sru.LP 6675584Sruwhere 6775584Sru.I n 6875584Sruis a decimal integer giving the position of the character in the font, 6975584Sruand 7075584Sru.IR c1 , 7175584Sru.IR c2 ,.\|.\|. 7275584Sruare the groff names of the character. 7375584SruIf a character has no groff names but exists in the tfm file, 7475584Sruthen it will be put in the groff font file as an unnamed character. 7575584Sru.I font 7675584Sruis the name of the groff font file. 7775584SruThe groff font file is written to 7875584Sru.IR font . 7975584Sru.LP 8075584SruThe 8175584Sru.B \-s 8275584Sruoption should be given if the font is special 8375584Sru(a font is 8475584Sru.I special 8575584Sruif 8675584Sru.B troff 8775584Srushould search it whenever 8875584Srua character is not found in the current font.) 8975584SruIf the font is special, 9075584Sruit should be listed in the 9175584Sru.B fonts 9275584Srucommand in the DESC file; 9375584Sruif it is not special, there is no need to list it, since 9475584Sru.B troff 9575584Srucan automatically mount it when it's first used. 9675584Sru.LP 9775584SruTo do a good job of math typesetting, groff requires 9875584Srufont metric information not present in the tfm file. 9975584SruThe reason for this is that \*(tx has separate math italic fonts 10075584Sruwhereas groff uses normal italic fonts for math. 10175584SruThe additional information required by groff is given by the 10275584Srutwo arguments to the 10375584Sru.B math_fit 10475584Srumacro in the Metafont programs for the Computer Modern fonts. 10575584SruIn a text font (a font for which 10675584Sru.B math_fitting 10775584Sruis false), Metafont normally ignores these two arguments. 10875584SruMetafont can be made to put this information in the gf file 10975584Sruby loading the following definition after 11075584Sru.B cmbase 11175584Sruwhen creating 11275584Sru.BR cm.base : 11375584Sru.IP 11475584Sru.nf 11575584Sru.ft B 11675584Srudef ignore_math_fit(expr left_adjustment,right_adjustment) = 11775584Sru special "adjustment"; 11875584Sru numspecial left_adjustment*16/designsize; 11975584Sru numspecial right_adjustment*16/designsize; 12075584Sru enddef; 12175584Sru.fi 12275584Sru.ft R 12375584Sru.LP 124104862SruFor the EC font family, load the following definition after 125104862Sru.B exbase 126104862Sru(it is probably easiest to patch 127104862Sru.B exbase.mf 128104862Srulocally): 129104862Sru.IP 130104862Sru.nf 131104862Sru.ft B 132104862Srudef ignore_math_fit(expr left_adjustment,right_adjustment) = 133104862Sru ori_special "adjustment"; 134104862Sru ori_numspecial left_adjustment*16/designsize; 135104862Sru ori_numspecial right_adjustment*16/designsize; 136104862Sru enddef; 137104862Sru.fi 138104862Sru.ft R 139104862Sru.LP 14075584SruThe gf file created using this modified 14175584Sru.B cm.base 142104862Sruor 143104862Sru.B exbase 14475584Srushould be specified with the 14575584Sru.B \-g 14675584Sruoption. 14775584SruThe 14875584Sru.B \-g 14975584Sruoption should not be given for a font for which 15075584Sru.B math_fitting 15175584Sruis true. 15275584Sru.SH OPTIONS 15375584Sru.TP 15475584Sru.B \-v 15575584SruPrint the version number. 15675584Sru.TP 15775584Sru.B \-s 15875584SruThe font is special. 15975584SruThe effect of this option is to add the 16075584Sru.B special 16175584Srucommand to the font file. 16275584Sru.TP 16375584Sru.BI \-k n 16475584SruThe skewchar of this font is at position 16575584Sru.IR n . 16675584Sru.I n 16775584Srushould be an integer; 16875584Sruit may be given in decimal, 16975584Sruor with a leading 17075584Sru.B 0 17175584Sruin octal, 17275584Sruor with a leading 17375584Sru.B 0x 17475584Sruin hexadecimal. 17575584SruThe effect of this option is to ignore any kerns whose second component 17675584Sruis the specified character. 17775584Sru.TP 17875584Sru.BI \-g gf_file 17975584Sru.I gf_file 18075584Sruis a gf file produced by Metafont containing special and numspecial 18175584Srucommands giving additional font metric information. 18275584Sru.SH FILES 18375584Sru.Tp \w'\fB@FONTDIR@/devdvi/DESC'u+2n 18475584Sru.B @FONTDIR@/devdvi/DESC 18575584SruDevice description file. 18675584Sru.TP 18775584Sru.BI @FONTDIR@/devdvi/ F 18875584SruFont description file for font 18975584Sru.IR F . 19075584Sru.SH "SEE ALSO" 19175584Sru.BR groff (@MAN1EXT@), 19275584Sru.BR grodvi (@MAN1EXT@), 19375584Sru.BR groff_font (@MAN5EXT@) 19479543Sru. 19579543Sru.\" Local Variables: 19679543Sru.\" mode: nroff 19779543Sru.\" End: 198