Name

       tfmtodit - adapt TeX Font Metrics files for use with groff and grodvi

Synopsis

       tfmtodit [-s] [-g gf-file] [-k skew-char] tfm-file map-file font-description

       tfmtodit --help

       tfmtodit -v
       tfmtodit --version

Description

       tfmtodit  creates a font description file for use with groff(1)'s dvi output device.  tfm-
       file is the name of the TeX font  metric  file  for  the  font.   map-file  assigns  groff
       ordinary  or special character identifiers to glyph indices in the font; it should consist
       of a sequence of lines of the form
              i c1 ... cn
       where i is a position of the glyph in the font in decimal, and c1  through  cn  are  glyph
       identifiers  in  the  form used by groff font descriptions.  If a glyph has no groff names
       but exists in tfm-file, it is put in the groff font description file as an unnamed  glyph.
       Output  is  written  in  groff_font(5)  format  to  font-description, a file named for the
       intended groff font name.

       If the font is “special”, meaning that groff should search it  whenever  a  glyph  is  not
       found  in  the  current  font,  use  the  -s option and name font-description in the fonts
       directive in the output device's DESC file.

       To do a good job of math typesetting, groff requires font metric information  not  present
       in  tfm-file.   This  is  because  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_fit is  false),  Metafont  normally  ignores
       these  two  arguments.  Metafont can be made to put this information into the GF (“generic
       font”) files it produces 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; consider patching
       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 only difference from the previous example  is  the  “ori_”  prefix  to  “special”  and
       “numspecial”.   The  GF  file  created  using this modified cm.base or exbase.mf should be
       specified with the -g option, which should not be given for a font for which  math_fit  is
       true.

Options

       --help displays a usage message, while -v and --version show version information; all exit
       afterward.

       -g gf-file
              Use the gf-file produced by Metafont containing “special” and “numspecial” commands
              to obtain additional font metric information.

       -k skew-char
              The  skew  character of this font is at position skew-char.  skew-char should be an
              integer; it may be given in decimal, with a leading 0 in octal, or with  a  leading
              0x in hexadecimal.  Any kerns whose second component is skew-char are ignored.

       -s     Add the special directive to the font description file.

Files

       /usr/share/groff/1.23.0/font/devdvi/DESC
              describes the dvi output device.

       /usr/share/groff/1.23.0/font/devdvi/F
              describes the font known as F on device dvi.

       /usr/share/groff/1.23.0/font/devdvi/generate/ec.map
       /usr/share/groff/1.23.0/font/devdvi/generate/msam.map
       /usr/share/groff/1.23.0/font/devdvi/generate/msbm.map
       /usr/share/groff/1.23.0/font/devdvi/generate/tc.map
       /usr/share/groff/1.23.0/font/devdvi/generate/texb.map
       /usr/share/groff/1.23.0/font/devdvi/generate/texex.map
       /usr/share/groff/1.23.0/font/devdvi/generate/texi.map
       /usr/share/groff/1.23.0/font/devdvi/generate/texitt.map
       /usr/share/groff/1.23.0/font/devdvi/generate/texmi.map
       /usr/share/groff/1.23.0/font/devdvi/generate/texr.map
       /usr/share/groff/1.23.0/font/devdvi/generate/texsy.map
       /usr/share/groff/1.23.0/font/devdvi/generate/textex.map
       /usr/share/groff/1.23.0/font/devdvi/generate/textt.map
              map glyph indices in TeX fonts to groff ordinary and special character identifiers.
              ec.map is used for TREC, TIEC, TBEC, TBIEC, HREC,  HIEC,  HBEC,  HBIEC,  CWEC,  and
              CWIEC;  msam.map for SA; msbm.map for SB; tc.map for TRTC, TITC, TBTC, TBITC, HRTC,
              HITC, HBTC, HBITC, CWTC, and CWITC; texb.map for TB, HR, HI, HB, and HBI; texex.map
              for EX; texi.map for TI and TBI; texitt.map for CWI; texmi.map for MI; texr.map for
              TR; texsy.map for S; textex.map for SC; and textt.map for CW.

See also

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