grodvi(1)

1grodvi(1)                   General Commands Manual                  grodvi(1)
2
3
4

Name

6       grodvi - groff output driver for TeX DVI format
7

Synopsis

9       grodvi [-dl] [-F dir] [-p paper-format] [-w n] [file ...]
10
11       grodvi --help
12
13       grodvi -v
14       grodvi --version
15

Description

17       The  GNU  roff DVI output driver translates the output of troff(1) into
18       TeX DVI format.  Normally, grodvi is invoked by groff(1) when the  lat‐
19       ter is given the “-T dvi” option.  (In this installation, ps is the de‐
20       fault output device.)  Use groff's -P option to pass any options  shown
21       above  to  grodvi.   If no file arguments are given, or if file is “-”,
22       grodvi reads the standard input stream.  Output is written to the stan‐
23       dard output stream.
24
25       The DVI file generated by grodvi can interpreted by any correctly writ‐
26       ten DVI driver.  troff drawing primitives are  implemented  using  tpic
27       version  2  specials.   If the driver does not support these, \D escape
28       sequences will not produce any output.
29
30       Encapsulated PostScript (EPS) files can be  easily  included;  use  the
31       PSPIC  macro.   pspic.tmac  is  loaded  automatically by dvi.tmac.  See
32       groff_tmac(5).
33
34       The default color used by the \m and  \M  escape  sequences  is  black.
35       Currently,  the  stroke color for \D drawing escape sequences is black;
36       fill color values are translated to gray.
37
38       In groff, as in AT&T troff, the \N escape sequence can be used  to  ac‐
39       cess any glyph in the current font by its position in the corresponding
40       TFM file.
41
42       By design, the DVI format doesn't care about the physical dimensions of
43       the  output  medium.   Instead,  grodvi  emits  the equivalent to TeX's
44       \special{papersize=width,length} on the first page; dvips  (or  another
45       DVI  driver)  then  sets the page size accordingly.  If either the page
46       width or length is not positive, no papersize special is output.
47
48       A device control escape sequence \X'anything' is translated to the same
49       DVI  file  instructions  as  would be produced by \special{anything} in
50       TeX; anything cannot contain a newline.
51
52   Typefaces
53       grodvi supports the standard four styles:  R  (roman),  I  (italic),  B
54       (bold),  and BI (bold-italic).  Fonts are grouped into families T and H
55       having members in each style.  “CM” abbreviates “Computer Modern”.
56
57              TR     CM Roman (cmr10)
58              TI     CM Text Italic (cmti10)
59              TB     CM Bold Extended Roman (cmbx10)
60              TBI    CM Bold Extended Text Italic (cmbxti10)
61              HR     CM Sans Serif (cmss10)
62              HI     CM Slanted Sans Serif (cmssi10)
63              HB     CM Sans Serif Bold Extended (cmssbx10)
64              HBI    CM Slanted Sans Serif Bold Extended (cmssbxo10)
65
66       The following fonts are not members of a family.
67
68              CW     CM Typewriter Text (cmtt10)
69              CWI    CM Italic Typewriter Text (cmitt10)
70
71       Special fonts include MI (cmmi10), S (cmsy10),  EX  (cmex10),  SC  (cm‐
72       tex10, only for CW), and, perhaps surprisingly, TR, TI, and CW, because
73       TeX places some glyphs in text fonts that  troff  generally  does  not.
74       For italic fonts, CWI is used instead of CW.
75
76       Finally,  the  symbol  fonts  of  the American Mathematical Society are
77       available as special fonts SA (msam10) and SB (msbm10).  They  are  are
78       not mounted by default.
79
80       The  troff  option  -mec loads the ec.tmac macro file, employing the EC
81       and TC fonts instead of CM.  These are designed similarly to  the  Com‐
82       puter  Modern  fonts;  further,  they  provide Euro \[Eu] and per mille
83       \[%0] glyphs.  ec.tmac must  be  loaded  before  any  language-specific
84       macro  files  because  it does not set up the codes necessary for auto‐
85       matic hyphenation.
86
87   Font description files
88       Use tfmtodit(1) to create groff font description files  from  TFM  (TeX
89       font metrics) files.  The font description file should contain the fol‐
90       lowing additional directives, which tfmtodit generates automatically.
91
92       internalname name
93              The name of the TFM file (without the .tfm extension) is name.
94
95       checksum n
96              The checksum in the TFM file is n.
97
98       designsize n
99              The design size in the TFM file is n.
100
101   Drawing commands
102       grodvi supports an additional drawing command.
103
104       \D'R dh dv'
105              Draw a rule (solid black rectangle) with one corner at the draw‐
106              ing  position, and the diagonally opposite corner at the drawing
107              position +(dh,dv), which becomes the new drawing position after‐
108              ward.   This  command produces a rule in the DVI file and so can
109              be printed even with a driver that does not  support  tpic  spe‐
110              cials, unlike the other \D commands.
111

Options

113       --help  displays  a  usage message, while -v and --version show version
114       information; all exit afterward.
115
116       -d     Do not use tpic specials to implement drawing  commands.   Hori‐
117              zontal and vertical lines are implemented by rules.  Other draw‐
118              ing commands are ignored.
119
120       -F dir Prepend directory dir/devname to the search path  for  font  and
121              device  description  files; name is the name of the device, usu‐
122              ally dvi.
123
124       -l     Use landscape orientation rather than portrait.
125
126       -p paper-format
127              Set  physical  dimensions  of  output  medium,  overriding   the
128              papersize,  paperlength,  and  paperwidth directives in the DESC
129              file.   paper-format  can  be  any  argument  accepted  by   the
130              papersize directive; see groff_font(5).
131
132       -w n   Draw  rules  (lines) with a thickness of n thousandths of an em.
133              The default thickness is 40 (0.04 em).
134

Environment

136       GROFF_FONT_PATH
137              lists directories in which to search for devdvi, grodvi's direc‐
138              tory  of  device  and  font description files.  See troff(1) and
139              groff_font(5).
140

Files

142       /usr/share/groff/1.23.0/font/devdvi/DESC
143              describes the dvi output device.
144
145       /usr/share/groff/1.23.0/font/devdvi/F
146              describes the font known as F on device dvi.
147
148       /usr/share/groff/1.23.0/tmac/dvi.tmac
149              defines font mappings, special characters, and  colors  for  use
150              with  the  dvi  output  device.   It  is automatically loaded by
151              troffrc when the dvi output device is selected.
152
153       /usr/share/groff/1.23.0/tmac/ec.tmac
154              configures the dvi output device to use the EC and TC font fami‐
155              lies instead of CM (Computer Modern).
156

Bugs

158       DVI  files  produced by grodvi use a different resolution (57,816 units
159       per inch) from those produced  by  TeX.   Incorrectly  written  drivers
160       which  assume the resolution used by TeX, rather than using the resolu‐
161       tion specified in the DVI file, will not work with grodvi.
162
163       When using the -d option with boxed  tables,  vertical  and  horizontal
164       lines  can  sometimes  protrude by one pixel.  This is a consequence of
165       the way TeX requires that the heights and widths of rules be rounded.
166