2 Copyright (C) 1989-2000, 2001, 2002, 2003, 2004, 2006, 2009
3 Free Software Foundation, Inc.
5 Permission is granted to make and distribute verbatim copies of
6 this manual provided the copyright notice and this permission notice
7 are preserved on all copies.
9 Permission is granted to copy and distribute modified versions of this
10 manual under the conditions for verbatim copying, provided that the
11 entire resulting derived work is distributed under the terms of a
12 permission notice identical to this one.
14 Permission is granted to copy and distribute translations of this
15 manual into another language, under the above conditions for modified
16 versions, except that this permission notice may be included in
17 translations approved by the Free Software Foundation instead of in
21 .do nr grodvi_C \n[.C]
24 .ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
27 .\" Like TP, but if specified indent is more than half
28 .\" the current line-length - indent, use the default indent.
30 . ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
41 . if '\\*(.T'dvi' .ft \\$1
45 .TH GRODVI @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
47 grodvi \- convert groff output to TeX dvi format
64 It is possible to have whitespace between a command line option and its
72 that produces \*(tx dvi format.
74 Normally it should be run by
78 .BR @g@troff\ \-Tdvi ;
79 it will also input the macros in
80 .BR @MACRODIR@/dvi.tmac .
83 The dvi file generated by
85 can be printed by any correctly-written dvi driver.
87 The troff drawing primitives are implemented
88 using the tpic version\~2 specials.
90 If the driver does not support these, the
92 commands will not produce any output.
95 There is an additional drawing command available:
98 .BI \[rs]D'R\ dh\ dv '
99 Draw a rule (solid black rectangle), with one corner
100 at the current position, and the diagonally opposite corner
101 at the current position
104 Afterwards the current position will be at the opposite corner.
106 This produces a rule in the dvi file and so can be printed even with a
107 driver that does not support the tpic specials unlike the other
113 .BI \[rs]X' anything '
114 is translated into the same command in the dvi file as would be
116 .BI \[rs]special{ anything }
119 may not contain a newline.
122 For inclusion of EPS image files,
126 automatically, providing the
131 .BR groff_tmac (@MAN5EXT@)
132 for a detailed description.
137 can be created from tfm files using
138 .BR tfmtodit (@MAN1EXT@).
140 The font description file should contain the following
143 .Tp \w'\fBinternalname'u+2n
144 .BI internalname\ name
145 The name of the tfm file (without the
152 The checksum in the tfm file is
157 The designsize in the tfm file is
161 These are automatically generated by
165 The default color for
171 Currently, the drawing color for
173 commands is always black, and fill color values are translated to gray.
180 escape sequence can be used to access characters by their position
181 in the corresponding tfm file;
182 all characters in the tfm file can be accessed this way.
185 By design, the DVI format doesn't care about physical dimensions of the
190 emits the equivalent to \*(tx's
191 .BI \[rs]special{papersize= width , length }
194 (and possibly other DVI drivers) then sets the page size accordingly.
196 If either the page width or length is not positive, no papersize special
203 Do not use tpic specials to implement drawing commands.
205 Horizontal and vertical lines will be implemented by rules.
207 Other drawing commands will be ignored.
213 to the search path for font and device description files;
215 is the name of the device, usually
220 Specify landscape orientation.
224 Specify paper dimensions.
233 file; it accepts the same arguments as the
236 .BR groff_font (@MAN5EXT@)
241 Print the version number.
245 Set the default line thickness to
247 thousandths of an em.
248 If this option isn't specified, the line thickness defaults to 0.04\~em.
252 There are styles called
258 mounted at font positions 1 to\ 4.
259 The fonts are grouped into families
263 having members in each of these styles:
275 CM Text Italic (cmti10)
281 CM Bold Extended Roman (cmbx10)
287 CM Bold Extended Text Italic (cmbxti10)
293 CM Sans Serif (cmss10)
299 CM Slanted Sans Serif (cmssi10)
305 CM Sans Serif Bold Extended (cmssbx10)
311 CM Slanted Sans Serif Bold Extended (cmssbxo10)
316 There are also the following fonts which are not members of a family:
321 CM Typewriter Text (cmtt10)
327 CM Italic Typewriter Text (cmitt10)
343 and, perhaps surprisingly,
348 due to the different font encodings of text fonts.
356 Finally, the symbol fonts of the American Mathematical Society are available
363 These two fonts are not mounted by default.
368 (which loads the file
370 provides the EC and TC fonts.
372 The design of the EC family is very similar to that of the CM fonts;
373 additionally, they give a much better coverage of groff symbols.
377 must be called before any language-specific files; it doesn't take care of
385 A list of directories in which to search for the
387 directory in addition to the default ones.
390 .BR @g@troff (@MAN1EXT@)
392 .BR \%groff_font (@MAN5EXT@)
398 .B @FONTDIR@/devdvi/DESC
399 Device description file.
402 .BI @FONTDIR@/devdvi/ F
403 Font description file for font
407 .B @MACRODIR@/dvi.tmac
412 .B @MACRODIR@/ec.tmac
413 Macros to switch to EC fonts.
417 Dvi files produced by
419 use a different resolution (57816 units per inch) to those produced by
422 Incorrectly written drivers which assume the resolution used by \*(tx,
423 rather than using the resolution specified in the dvi file will not
430 option with boxed tables,
431 vertical and horizontal lines can sometimes protrude by one pixel.
433 This is a consequence of the way \*(tx requires that the heights
434 and widths of rules be rounded.
438 .BR tfmtodit (@MAN1EXT@),
439 .BR groff (@MAN1EXT@),
440 .BR @g@troff (@MAN1EXT@),
441 .BR groff_out (@MAN5EXT@),
442 .BR groff_font (@MAN5EXT@),
443 .BR groff_char (@MAN7EXT@),
444 .BR groff_tmac (@MAN5EXT@)