Provided by: groff_1.23.0-3build2_amd64 bug

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.
       Normally, 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”
       abbreviates “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
              device.  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
       protrude 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?”   ⟨https://texfaq.org/FAQ-ECfonts⟩;  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)