man > GRODVI(1)

grodvi(1)                              General Commands Manual                             grodvi(1)

Name
       grodvi - groff output driver for TeX DVI format

Synopsis
       grodvi [-dl] [-F dir] [-p paper-format] [-w n] [file ...]

       grodvi --help

       grodvi -v
       grodvi --version

Description
       The  GNU  roff DVI output driver translates the output of troff(1) into TeX DVI format.  Nor‐
       mally, grodvi is invoked by groff(1) when the latter is given the “-T dvi” option.  (In  this
       installation,  ps  is  the default output device.)  Use groff's -P option to pass any options
       shown above to grodvi.  If no file arguments are given, or if file is “-”, grodvi  reads  the
       standard input stream.  Output is written to the standard output stream.

       The  DVI file generated by grodvi can interpreted by any correctly written DVI driver.  troff
       drawing primitives are implemented using tpic version 2 specials.  If  the  driver  does  not
       support these, \D escape sequences will not produce any output.

       Encapsulated  PostScript (EPS) files can be easily included; use the PSPIC macro.  pspic.tmac
       is loaded automatically by dvi.tmac.  See groff_tmac(5).

       The default color used by the \m and \M escape sequences is  black.   Currently,  the  stroke
       color for \D drawing escape sequences is black; fill color values are translated to gray.

       In  groff,  as  in  AT&T troff, the \N escape sequence can be used to access any glyph in the
       current font by its position in the corresponding TFM file.

       By design, the DVI format doesn't care about the physical dimensions of  the  output  medium.
       Instead,  grodvi  emits the equivalent to TeX's \special{papersize=width,length} on the first
       page; dvips (or another DVI driver) then sets the page size accordingly.  If either the  page
       width or length is not positive, no papersize special is output.

       A device control escape sequence \X'anything' is translated to the same DVI file instructions
       as would be produced by \special{anything} in TeX; anything cannot contain a newline.

   Typefaces
       grodvi  supports  the  standard  four  styles: R (roman), I (italic), B (bold), and BI (bold-
       italic).  Fonts are grouped into families T and H having members in each style.  “CM”  abbre‐
       viates “Computer Modern”.

              TR     CM Roman (cmr10)
              TI     CM Text Italic (cmti10)
              TB     CM Bold Extended Roman (cmbx10)
              TBI    CM Bold Extended Text Italic (cmbxti10)
              HR     CM Sans Serif (cmss10)
              HI     CM Slanted Sans Serif (cmssi10)
              HB     CM Sans Serif Bold Extended (cmssbx10)
              HBI    CM Slanted Sans Serif Bold Extended (cmssbxo10)

       The following fonts are not members of a family.

              CW     CM Typewriter Text (cmtt10)
              CWI    CM Italic Typewriter Text (cmitt10)

       Special  fonts  include MI (cmmi10), S (cmsy10), EX (cmex10), SC (cmtex10, only for CW), and,
       perhaps surprisingly, TR, TI, and CW, because TeX places some glyphs in text fonts that troff
       generally does not.  For italic fonts, CWI is used instead of CW.

       Finally, the symbol fonts of the American Mathematical Society are available as special fonts
       SA (msam10) and SB (msbm10).  They are are not mounted by default.

       The troff option -mec loads the ec.tmac macro file, employing the EC and TC fonts instead  of
       CM.   These  are  designed similarly to the Computer Modern fonts; further, they provide Euro
       \[Eu] and per mille \[%0] glyphs.  ec.tmac must be loaded before any language-specific  macro
       files because it does not set up the codes necessary for automatic hyphenation.

   Font description files
       Use  tfmtodit(1)  to  create  groff font description files from TFM (TeX font metrics) files.
       The font description file should contain the following additional directives, which  tfmtodit
       generates automatically.

       internalname name
              The name of the TFM file (without the .tfm extension) is name.

       checksum n
              The checksum in the TFM file is n.

       designsize n
              The design size in the TFM file is n.

   Drawing commands
       grodvi supports an additional drawing command.

       \D'R dh dv'
              Draw  a  rule (solid black rectangle) with one corner at the drawing position, and the
              diagonally opposite corner at the drawing position +(dh,dv),  which  becomes  the  new
              drawing  position  afterward.  This command produces a rule in the DVI file and so can
              be printed even with a driver that does not support tpic specials, unlike the other \D
              commands.

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

       -d     Do not use tpic specials to implement drawing commands.  Horizontal and vertical lines
              are implemented by rules.  Other drawing commands are ignored.

       -F dir Prepend  directory  dir/devname  to  the  search  path for font and device description
              files; name is the name of the device, usually dvi.

       -l     Use landscape orientation rather than portrait.

       -p paper-format
              Set physical dimensions of output medium, overriding the papersize,  paperlength,  and
              paperwidth  directives in the DESC file.  paper-format can be any argument accepted by
              the papersize directive; see groff_font(5).

       -w n   Draw rules (lines) with a thickness of n thousandths of an em.  The default  thickness
              is 40 (0.04 em).

Environment
       GROFF_FONT_PATH
              lists directories in which to search for devdvi, grodvi's directory of device and font
              description files.  See troff(1) and groff_font(5).

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/tmac/dvi.tmac
              defines  font mappings, special characters, and colors for use with the dvi output de‐
              vice.  It is automatically loaded by troffrc when the dvi output device is selected.

       /usr/share/groff/1.23.0/tmac/ec.tmac
              configures the dvi output device to use the EC and TC  font  families  instead  of  CM
              (Computer Modern).

Bugs
       DVI  files  produced  by grodvi use a different resolution (57,816 units per inch) from those
       produced by TeX.  Incorrectly written drivers which assume the resolution used by TeX, rather
       than using the resolution specified in the DVI file, will not work with grodvi.

       When using the -d option with boxed tables, vertical and horizontal lines can sometimes  pro‐
       trude  by  one  pixel.   This  is  a consequence of the way TeX requires that the heights and
       widths of rules be rounded.

See also
       “What are the EC fonts?”; TeX FAQ: Frequently Asked Question List for TeX

       tfmtodit(1), groff(1), troff(1), groff_out(5), groff_font(5), groff_char(7), groff_tmac(5)

groff 1.23.0                                31 March 2024                                  grodvi(1)