# GRODVI(1) - man - phpMan [GRODVI(1)](https://www.chedong.com/phpMan.php/man/GRODVI/1/markdown) General Commands Manual [GRODVI(1)](https://www.chedong.com/phpMan.php/man/GRODVI/1/markdown) ## NAME grodvi - convert groff output to TeX DVI format ## SYNOPSIS **grodvi** [**-dl**] [**-F** _dir_] [**-p** _papersize_] [**-w** _n_] [_file_ ...] ### grodvi --help ### grodvi -v ### grodvi --version ## DESCRIPTION **grodvi** is a driver for **groff** that produces TeX DVI format. Normally it should be run by **groff** **-Tdvi**. This will run **troff** **-Tdvi**; it will also input the macros in _/usr/share/groff/_ _1.22.4/tmac/dvi.tmac_. The DVI file generated by **grodvi** can be printed by any correctly-written DVI driver. The troff drawing primitives are implemented using the tpic version 2 specials. If the driver does not support these, the **\D** commands will not produce any output. There is an additional drawing command available: **\D'R** _dh_ _dv_**'** Draw a rule (solid black rectangle), with one corner at the current position, and the diagonally opposite corner at the current position +(_dh_,_dv_). Afterwards the current position will be at the opposite corner. This produces a rule in the DVI file and so can be printed even with a driver that does not support the tpic specials unlike the other **\D** commands. The groff command **\X'**_anything_**'** is translated into the same command in the DVI file as would be produced by **\special{**_anything_**}** in TeX; _anything_ may not contain a newline. For inclusion of EPS image files, **-Tdvi** loads _pspic.tmac_ automatically, providing the **PSPIC** macro. Please check **groff**___**[tmac**(5)](https://www.chedong.com/phpMan.php/man/tmac/5/markdown) for a detailed description. Font files for **grodvi** can be created from tfm files using [**tfmtodit**(1)](https://www.chedong.com/phpMan.php/man/tfmtodit/1/markdown). The font description file should contain the following additional commands: **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 designsize in the tfm file is _n_. These are automatically generated by **tfmtodit.** The default color for **\m** and **\M** is black. Currently, the drawing color for **\D** commands is always black, and fill color values are translated to gray. In **troff** the **\N** escape sequence can be used to access characters by their position in the corresponding tfm file; all characters in the tfm file can be accessed this way. By design, the DVI format doesn't care about physical dimensions of the output medium. In‐ stead, **grodvi** emits the equivalent to TeX's **\special{papersize=**_width_**,**_length_**}** on the first page; **dvips** (and possibly other DVI drivers) then sets the page size accordingly. If either the page width or length is not positive, no papersize special is output. ## OPTIONS Whitespace is permitted between a command-line option and its argument. ### -d will be implemented by rules. Other drawing commands will be ignored. ### -F files; _name_ is the name of the device, usually **dvi**. ### -l ### -p Specify paper dimensions. This overrides the **papersize**, **paperlength**, and **paperwidth** commands in the _DESC_ file; it accepts the same arguments as the **papersize** command (see **groff**___**[font**(5)](https://www.chedong.com/phpMan.php/man/font/5/markdown) for details). ### -v ### -w fied, the line thickness defaults to 0.04 em. ## USAGE There are styles called **R**, **I**, **B**, and **BI** mounted at font positions 1 to 4. The fonts are grouped into families **T** and **H** having members in each of these styles: **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) There are also the following fonts which are not members of a family: **CW** CM Typewriter Text (cmtt10) **CWI** CM Italic Typewriter Text (cmitt10) Special fonts are **MI** (cmmi10), **S** (cmsy10), **EX** (cmex10), **SC** (cmtex10, only for **CW**), and, per‐ haps surprisingly, **TR**, **TI**, and **CW**, due to the different font encodings of text fonts. 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). These two fonts are not mounted by default. Using the option **-mec** (which loads the file _ec.tmac_) provides the EC and TC fonts. The de‐ sign of the EC family is very similar to that of the CM fonts; additionally, they give a much better coverage of groff symbols. Note that _ec.tmac_ must be called before any language-spe‐ cific files; it doesn't take care of hcode values. ## ENVIRONMENT _GROFF_FONT_PATH_ A list of directories in which to search for the _dev_name directory in addition to the default ones. See [**troff**(1)](https://www.chedong.com/phpMan.php/man/troff/1/markdown) and **groff**___**[font**(5)](https://www.chedong.com/phpMan.php/man/font/5/markdown) for more details. ## FILES _/usr/share/groff/1.22.4/font/devdvi/DESC_ Device description file. _/usr/share/groff/1.22.4/font/devdvi/_F Font description file for font _F_. _/usr/share/groff/1.22.4/tmac/dvi.tmac_ Macros for use with **grodvi**. _/usr/share/groff/1.22.4/tmac/ec.tmac_ Macros to switch to EC fonts. ## BUGS Dvi files produced by **grodvi** use a different resolution (57816 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 [**tfmtodit**(1)](https://www.chedong.com/phpMan.php/man/tfmtodit/1/markdown), [**groff**(1)](https://www.chedong.com/phpMan.php/man/groff/1/markdown), [**troff**(1)](https://www.chedong.com/phpMan.php/man/troff/1/markdown), **groff**___**[out**(5)](https://www.chedong.com/phpMan.php/man/out/5/markdown), **groff**___**[font**(5)](https://www.chedong.com/phpMan.php/man/font/5/markdown), **groff**___**[char**(7)](https://www.chedong.com/phpMan.php/man/char/7/markdown), **groff**___**[tmac**(5)](https://www.chedong.com/phpMan.php/man/tmac/5/markdown) groff 1.22.4 23 March 2022 [GRODVI(1)](https://www.chedong.com/phpMan.php/man/GRODVI/1/markdown)