Home | History | Annotate | Line # | Download | only in tfmtodit
      1 .ig
      2 Copyright (C) 1989-2000, 2001, 2002 Free Software Foundation, Inc.
      3 
      4 Permission is granted to make and distribute verbatim copies of
      5 this manual provided the copyright notice and this permission notice
      6 are preserved on all copies.
      7 
      8 Permission is granted to copy and distribute modified versions of this
      9 manual under the conditions for verbatim copying, provided that the
     10 entire resulting derived work is distributed under the terms of a
     11 permission notice identical to this one.
     12 
     13 Permission is granted to copy and distribute translations of this
     14 manual into another language, under the above conditions for modified
     15 versions, except that this permission notice may be included in
     16 translations approved by the Free Software Foundation instead of in
     17 the 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
     29 tfmtodit \- 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
     50 It is possible to have whitespace between a command line option and its
     51 parameter.
     52 .SH DESCRIPTION
     53 .B tfmtodit
     54 creates a font file for use with
     55 .B
     56 groff \-Tdvi\fR.
     57 .I tfm_file
     58 is the name of the \*(tx font metric file for the font.
     59 .I map_file
     60 is a file giving the groff names for characters in the font;
     61 this file should consist of a sequence of lines of the form:
     62 .IP
     63 .I
     64 n c1 c2 \fR.\|.\|.
     65 .LP
     66 where
     67 .I n
     68 is a decimal integer giving the position of the character in the font,
     69 and
     70 .IR c1 ,
     71 .IR c2 ,.\|.\|.
     72 are the groff names of the character.
     73 If a character has no groff names but exists in the tfm file,
     74 then it will be put in the groff font file as an unnamed character.
     75 .I font
     76 is the name of the groff font file.
     77 The groff font file is written to
     78 .IR font .
     79 .LP
     80 The
     81 .B \-s
     82 option should be given if the font is special
     83 (a font is
     84 .I special
     85 if
     86 .B troff
     87 should search it whenever
     88 a character is not found in the current font.)
     89 If the font is special,
     90 it should be listed in the
     91 .B fonts
     92 command in the DESC file;
     93 if it is not special, there is no need to list it, since
     94 .B troff
     95 can automatically mount it when it's first used.
     96 .LP
     97 To do a good job of math typesetting, groff requires
     98 font metric information not present in the tfm file.
     99 The reason for this is that \*(tx has separate math italic fonts
    100 whereas groff uses normal italic fonts for math.
    101 The additional information required by groff is given by the
    102 two arguments to the
    103 .B math_fit
    104 macro in the Metafont programs for the Computer Modern fonts.
    105 In a text font (a font for which
    106 .B math_fitting
    107 is false), Metafont normally ignores these two arguments.
    108 Metafont can be made to put this information in the gf file
    109 by loading the following definition after
    110 .B cmbase
    111 when creating
    112 .BR cm.base :
    113 .IP
    114 .nf
    115 .ft B
    116 def 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
    124 For the EC font family, load the following definition after
    125 .B exbase
    126 (it is probably easiest to patch
    127 .B exbase.mf
    128 locally):
    129 .IP
    130 .nf
    131 .ft B
    132 def 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
    140 The gf file created using this modified
    141 .B cm.base
    142 or
    143 .B exbase
    144 should be specified with the
    145 .B \-g
    146 option.
    147 The
    148 .B \-g
    149 option should not be given for a font for which
    150 .B math_fitting
    151 is true.
    152 .SH OPTIONS
    153 .TP
    154 .B \-v
    155 Print the version number.
    156 .TP
    157 .B \-s
    158 The font is special.
    159 The effect of this option is to add the
    160 .B special
    161 command to the font file.
    162 .TP
    163 .BI \-k n
    164 The skewchar of this font is at position
    165 .IR n .
    166 .I n
    167 should be an integer;
    168 it may be given in decimal,
    169 or with a leading 
    170 .B 0
    171 in octal,
    172 or with a leading
    173 .B 0x
    174 in hexadecimal.
    175 The effect of this option is to ignore any kerns whose second component
    176 is the specified character.
    177 .TP
    178 .BI \-g gf_file
    179 .I gf_file
    180 is a gf file produced by Metafont containing special and numspecial
    181 commands giving additional font metric information.
    182 .SH FILES
    183 .Tp \w'\fB@FONTDIR@/devdvi/DESC'u+2n
    184 .B @FONTDIR@/devdvi/DESC
    185 Device description file.
    186 .TP
    187 .BI @FONTDIR@/devdvi/ F
    188 Font 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