grodvi - Man Page

The GNU roff DVI output driver translates the output of troff(1) into T E X 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 T E X'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 T E X; anything cannot contain a newline.

--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).

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).

/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).

DVI files produced by grodvi use a different resolution (57,816 units per inch) from those produced by T E X. Incorrectly written drivers which assume the resolution used by T E X, 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 T E X requires that the heights and widths of rules be rounded.

“What are the EC fonts?”; T E X FAQ: Frequently Asked Question List for T E X

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

dvipdfmx(1), dvisvgm(1), groff(1), groff_out(5), tfmtodit(1).