1GRODVI(1) General Commands Manual GRODVI(1)
2
3
4
6 grodvi - convert groff output to TeX dvi format
7
9 grodvi [ -dlv ] [ -Fdir ] [ -ppapersize ] [ -wn ] [ files... ]
10
11 It is possible to have whitespace between a command line option and its
12 parameter.
13
15 grodvi is a driver for groff that produces TeX dvi format. Normally it
16 should be run by groff -Tdvi. This will run troff -Tdvi; it will also
17 input the macros in /usr/share/groff/1.22.3/tmac/dvi.tmac.
18
19 The dvi file generated by grodvi can be printed by any correctly-writ‐
20 ten dvi driver. The troff drawing primitives are implemented using the
21 tpic version 2 specials. If the driver does not support these, the \D
22 commands will not produce any output.
23
24 There is an additional drawing command available:
25
26 \D'R dh dv'
27 Draw a rule (solid black rectangle), with one corner at the cur‐
28 rent position, and the diagonally opposite corner at the current
29 position +(dh,dv). Afterwards the current position will be at
30 the opposite corner. This produces a rule in the dvi file and
31 so can be printed even with a driver that does not support the
32 tpic specials unlike the other \D commands.
33
34 The groff command \X'anything' is translated into the same command in
35 the dvi file as would be produced by \special{anything} in TeX; any‐
36 thing may not contain a newline.
37
38 For inclusion of EPS image files, -Tdvi loads pspic.tmac automatically,
39 providing the PSPIC macro. Please check groff_tmac(5) for a detailed
40 description.
41
42 Font files for grodvi can be created from tfm files using tfmtodit(1).
43 The font description file should contain the following additional com‐
44 mands:
45
46 internalname name
47 The name of the tfm file (without the .tfm extension) is
48 name.
49
50 checksum n The checksum in the tfm file is n.
51
52 designsize n The designsize in the tfm file is n.
53
54 These are automatically generated by tfmtodit.
55
56 The default color for \m and \M is black. Currently, the drawing color
57 for \D commands is always black, and fill color values are translated
58 to gray.
59
60 In troff the \N escape sequence can be used to access characters by
61 their position in the corresponding tfm file; all characters in the tfm
62 file can be accessed this way.
63
64 By design, the DVI format doesn't care about physical dimensions of the
65 output medium. Instead, grodvi emits the equivalent to TeX's \spe‐
66 cial{papersize=width,length} on the first page; dvips (and possibly
67 other DVI drivers) then sets the page size accordingly. If either the
68 page width or length is not positive, no papersize special is output.
69
71 -d Do not use tpic specials to implement drawing commands. Hori‐
72 zontal and vertical lines will be implemented by rules. Other
73 drawing commands will be ignored.
74
75 -Fdir Prepend directory dir/devname to the search path for font and
76 device description files; name is the name of the device, usu‐
77 ally dvi.
78
79 -l Specify landscape orientation.
80
81 -ppapersize
82 Specify paper dimensions. This overrides the papersize, paper‐
83 length, and paperwidth commands in the DESC file; it accepts the
84 same arguments as the papersize command (see groff_font(5) for
85 details).
86
87 -v Print the version number.
88
89 -wn Set the default line thickness to n thousandths of an em. If
90 this option isn't specified, the line thickness defaults to
91 0.04 em.
92
94 There are styles called R, I, B, and BI mounted at font positions 1
95 to 4. The fonts are grouped into families T and H having members in
96 each of these styles:
97
98 TR CM Roman (cmr10)
99 TI CM Text Italic (cmti10)
100 TB CM Bold Extended Roman (cmbx10)
101 TBI CM Bold Extended Text Italic (cmbxti10)
102 HR CM Sans Serif (cmss10)
103 HI CM Slanted Sans Serif (cmssi10)
104 HB CM Sans Serif Bold Extended (cmssbx10)
105 HBI CM Slanted Sans Serif Bold Extended (cmssbxo10)
106
107 There are also the following fonts which are not members of a family:
108
109 CW CM Typewriter Text (cmtt10)
110 CWI CM Italic Typewriter Text (cmitt10)
111
112 Special fonts are MI (cmmi10), S (cmsy10), EX (cmex10), SC (cmtex10,
113 only for CW), and, perhaps surprisingly, TR, TI, and CW, due to the
114 different font encodings of text fonts. For italic fonts, CWI is used
115 instead of CW.
116
117 Finally, the symbol fonts of the American Mathematical Society are
118 available as special fonts SA (msam10) and SB (msbm10). These two
119 fonts are not mounted by default.
120
121 Using the option -mec (which loads the file ec.tmac) provides the EC
122 and TC fonts. The design of the EC family is very similar to that of
123 the CM fonts; additionally, they give a much better coverage of groff
124 symbols. Note that ec.tmac must be called before any language-specific
125 files; it doesn't take care of hcode values.
126
128 GROFF_FONT_PATH
129 A list of directories in which to search for the devname direc‐
130 tory in addition to the default ones. See troff(1) and
131 groff_font(5) for more details.
132
134 /usr/share/groff/1.22.3/font/devdvi/DESC
135 Device description file.
136
137 /usr/share/groff/1.22.3/font/devdvi/F
138 Font description file for font F.
139
140 /usr/share/groff/1.22.3/tmac/dvi.tmac
141 Macros for use with grodvi.
142
143 /usr/share/groff/1.22.3/tmac/ec.tmac
144 Macros to switch to EC fonts.
145
147 Dvi files produced by grodvi use a different resolution (57816 units
148 per inch) to those produced by TeX. Incorrectly written drivers which
149 assume the resolution used by TeX, rather than using the resolution
150 specified in the dvi file will not work with grodvi.
151
152 When using the -d option with boxed tables, vertical and horizontal
153 lines can sometimes protrude by one pixel. This is a consequence of
154 the way TeX requires that the heights and widths of rules be rounded.
155
157 tfmtodit(1), groff(1), troff(1), groff_out(5), groff_font(5),
158 groff_char(7), groff_tmac(5)
159
161 Copyright © 1989-2014 Free Software Foundation, Inc.
162
163 Permission is granted to make and distribute verbatim copies of this
164 manual provided the copyright notice and this permission notice are
165 preserved on all copies.
166
167 Permission is granted to copy and distribute modified versions of this
168 manual under the conditions for verbatim copying, provided that the
169 entire resulting derived work is distributed under the terms of a per‐
170 mission notice identical to this one.
171
172 Permission is granted to copy and distribute translations of this man‐
173 ual into another language, under the above conditions for modified ver‐
174 sions, except that this permission notice may be included in transla‐
175 tions approved by the Free Software Foundation instead of in the origi‐
176 nal English.
177
178
179
180Groff Version 1.22.3 4 November 2014 GRODVI(1)