NAME

       tfmtodit - create font files for use with groff -Tdvi

SYNOPSIS

       tfmtodit [-s] [-g gf_file] [-k skewchar] tfm_file map_file font

       tfmtodit --help

       tfmtodit -v
       tfmtodit --version

DESCRIPTION

       tfmtodit  creates a font file for use with groff -Tdvi.  tfm_file is the name of the TeX font metric file
       for the font.  map_file is a file giving the groff names for characters in the  font;  this  file  should
       consist of a sequence of lines of the form:

              n c1 c2 ...

       where  n  is  a decimal integer giving the position of the character in the font, and c1, c2,...  are the
       groff names of the character.  If a character has no groff names but exists in the tfm file, then it will
       be put in the groff font file as an unnamed character.  font is the name of the  groff  font  file.   The
       groff font file is written to font.

       The  -s  option  should  be  given  if  the  font is special (a font is special if troff should search it
       whenever a character is not found in the current font.)  If the font is special, it should be  listed  in
       the  fonts  command  in the DESC file; if it is not special, there is no need to list it, since troff can
       automatically mount it when it's first used.

       To do a good job of math typesetting, groff requires font metric information not present in the tfm file.
       The reason for this is that TeX has separate math italic fonts whereas groff uses normal italic fonts for
       math.  The additional information required by groff is given by the two arguments to the  math_fit  macro
       in the Metafont programs for the Computer Modern fonts.  In a text font (a font for which math_fitting is
       false),  Metafont  normally ignores these two arguments.  Metafont can be made to put this information in
       the gf file by loading the following definition after cmbase when creating cm.base:

              def ignore_math_fit(expr left_adjustment,right_adjustment) =
                  special "adjustment";
                  numspecial left_adjustment*16/designsize;
                  numspecial right_adjustment*16/designsize;
                  enddef;

       For the EC font family, load the following definition after exbase  (it  is  probably  easiest  to  patch
       exbase.mf locally):

              def ignore_math_fit(expr left_adjustment,right_adjustment) =
                  ori_special "adjustment";
                  ori_numspecial left_adjustment*16/designsize;
                  ori_numspecial right_adjustment*16/designsize;
                  enddef;

       The gf file created using this modified cm.base or exbase should be specified with the -g option.  The -g
       option should not be given for a font for which math_fitting is true.

OPTIONS

       Whitespace is permitted between a command-line option and its argument.

       -v     Print the version number.

       -s     The font is special.  The effect of this option is to add the special command to the font file.

       -kn    The  skewchar  of this font is at position n.  n should be an integer; it may be given in decimal,
              or with a leading 0 in octal, or with a leading 0x in hexadecimal.  The effect of this  option  is
              to ignore any kerns whose second component is the specified character.

       -ggf_file
              gf_file  is  a  gf  file  produced  by  Metafont containing special and numspecial commands giving
              additional font metric information.

FILES

       /usr/share/groff/1.22.4/font/devdvi/DESC
              Device description file.

       /usr/share/groff/1.22.4/font/devdvi/F
              Font description file for font F.

SEE ALSO

       groff(1), grodvi(1), groff_font(5)

groff 1.22.4                                      23 March 2022                                      TFMTODIT(1)