grodvi(1) | User Commands | grodvi(1) |
grodvi - groff output driver for TeX DVI format
grodvi |
[-dl] [-F dir] [-p paper-format] [-w n] [file ...] |
grodvi |
--help |
grodvi |
-v |
grodvi |
--version |
The GNU roff DVI output driver translates the output of gtroff(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.
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”.
The following fonts are not members of a family.
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 gtroff 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.
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.
grodvi supports an additional drawing command.
--help displays a usage message, while -v and --version show version information; all exit afterward.
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.
“What are the EC fonts?”; TeX FAQ: Frequently Asked Question List for TeX
tfmtodit(1), groff(1), gtroff(1), groff_out(5), groff_font(5), groff_char(7), groff_tmac(5)
2 July 2023 | groff 1.23.0 |