2 Copyright (C) 1989-2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
4 Permission is granted to make and distribute verbatim copies of
5 this manual provided the copyright notice and this permission notice
6 are preserved on all copies.
8 Permission is granted to copy and distribute modified versions of this
9 manual under the conditions for verbatim copying, provided that the
10 entire resulting derived work is distributed under the terms of a
11 permission notice identical to this one.
13 Permission is granted to copy and distribute translations of this
14 manual into another language, under the above conditions for modified
15 versions, except that this permission notice may be included in
16 translations approved by the Free Software Foundation instead of in
20 .do nr grodvi_C \n[.C]
23 .ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
26 .\" Like TP, but if specified indent is more than half
27 .\" the current line-length - indent, use the default indent.
29 . ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
40 . if '\\*(.T'dvi' .ft \\$1
44 .TH GRODVI @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
46 grodvi \- convert groff output to TeX dvi format
63 It is possible to have whitespace between a command line option and its
71 that produces \*(tx dvi format.
73 Normally it should be run by
77 .BR @g@troff\ \-Tdvi ;
78 it will also input the macros in
79 .BR @MACRODIR@/dvi.tmac .
82 The dvi file generated by
84 can be printed by any correctly-written dvi driver.
86 The troff drawing primitives are implemented
87 using the tpic version\~2 specials.
89 If the driver does not support these, the
91 commands will not produce any output.
94 There is an additional drawing command available:
97 .BI \[rs]D'R\ dh\ dv '
98 Draw a rule (solid black rectangle), with one corner
99 at the current position, and the diagonally opposite corner
100 at the current position
103 Afterwards the current position will be at the opposite corner.
105 This produces a rule in the dvi file and so can be printed even with a
106 driver that does not support the tpic specials unlike the other
112 .BI \[rs]X' anything '
113 is translated into the same command in the dvi file as would be
115 .BI \[rs]special{ anything }
118 may not contain a newline.
121 For inclusion of EPS image files,
125 automatically, providing the
130 .BR groff_tmac (@MAN5EXT@)
131 for a detailed description.
136 can be created from tfm files using
137 .BR tfmtodit (@MAN1EXT@).
139 The font description file should contain the following
142 .Tp \w'\fBinternalname'u+2n
143 .BI internalname\ name
144 The name of the tfm file (without the
151 The checksum in the tfm file is
156 The designsize in the tfm file is
160 These are automatically generated by
164 The default color for
170 Currently, the drawing color for
172 commands is always black, and fill color values are translated to gray.
179 escape sequence can be used to access characters by their position
180 in the corresponding tfm file;
181 all characters in the tfm file can be accessed this way.
184 By design, the DVI format doesn't care about physical dimensions of the
189 emits the equivalent to \*(tx's
190 .BI \[rs]special{papersize= width , length }
193 (and possibly other DVI drivers) then sets the page size accordingly.
195 If either the page width or length is not positive, no papersize special
202 Do not use tpic specials to implement drawing commands.
204 Horizontal and vertical lines will be implemented by rules.
206 Other drawing commands will be ignored.
212 to the search path for font and device description files;
214 is the name of the device, usually
219 Specify landscape orientation.
223 Specify paper dimensions.
232 file; it accepts the same arguments as the
235 .BR groff_font (@MAN5EXT@)
240 Print the version number.
244 Set the default line thickness to
246 thousandths of an em.
247 If this option isn't specified, the line thickness defaults to 0.04\~em.
251 There are styles called
257 mounted at font positions 1 to\ 4.
258 The fonts are grouped into families
262 having members in each of these styles:
274 CM Text Italic (cmti10)
280 CM Bold Extended Roman (cmbx10)
286 CM Bold Extended Text Italic (cmbxti10)
292 CM Sans Serif (cmss10)
298 CM Slanted Sans Serif (cmssi10)
304 CM Sans Serif Bold Extended (cmssbx10)
310 CM Slanted Sans Serif Bold Extended (cmssbxo10)
315 There are also the following fonts which are not members of a family:
320 CM Typewriter Text (cmtt10)
326 CM Italic Typewriter Text (cmitt10)
342 and, perhaps surprisingly,
347 due to the different font encodings of text fonts.
355 Finally, the symbol fonts of the American Mathematical Society are available
362 These two fonts are not mounted by default.
367 (which loads the file
369 provides the EC and TC fonts.
371 The design of the EC family is very similar to that of the CM fonts;
372 additionally, they give a much better coverage of groff symbols.
376 must be called before any language-specific files; it doesn't take care of
382 .B @FONTDIR@/devdvi/DESC
383 Device description file.
386 .BI @FONTDIR@/devdvi/ F
387 Font description file for font
391 .B @MACRODIR@/dvi.tmac
396 .B @MACRODIR@/ec.tmac
397 Macros to switch to EC fonts.
401 Dvi files produced by
403 use a different resolution (57816 units per inch) to those produced by
406 Incorrectly written drivers which assume the resolution used by \*(tx,
407 rather than using the resolution specified in the dvi file will not
414 option with boxed tables,
415 vertical and horizontal lines can sometimes protrude by one pixel.
417 This is a consequence of the way \*(tx requires that the heights
418 and widths of rules be rounded.
422 .BR tfmtodit (@MAN1EXT@),
423 .BR groff (@MAN1EXT@),
424 .BR @g@troff (@MAN1EXT@),
425 .BR groff_out (@MAN5EXT@),
426 .BR groff_font (@MAN5EXT@),
427 .BR groff_char (@MAN7EXT@),
428 .BR groff_tmac (@MAN5EXT@)