grodvi.man revision 79543 
1120303Sru.ig
275592SruCopyright (C) 1989-2000, 2001 Free Software Foundation, Inc.
375592Sru
475592SruPermission is granted to make and distribute verbatim copies of
575592Sruthis manual provided the copyright notice and this permission notice
675592Sruare preserved on all copies.
775592Sru
875592SruPermission is granted to copy and distribute modified versions of this
975592Srumanual under the conditions for verbatim copying, provided that the
1075592Sruentire resulting derived work is distributed under the terms of a
1175592Srupermission notice identical to this one.
1275592Sru
1375592SruPermission is granted to copy and distribute translations of this
1475592Srumanual into another language, under the above conditions for modified
1575592Sruversions, except that this permission notice may be included in
1675592Srutranslations approved by the Free Software Foundation instead of in
1775592Sruthe original English.
1875592Sru..
1975592Sru.ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
2075592Sru.el .ds tx TeX
2175592Sru.\" Like TP, but if specified indent is more than half
2275592Sru.\" the current line-length - indent, use the default indent.
2375592Sru.de Tp
2475592Sru.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
2575592Sru.el .TP "\\$1"
2675592Sru..
2775592Sru.TH GRODVI @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
2875592Sru.SH NAME
2975592Srugrodvi \- convert groff output to TeX dvi format
30104709Sru.SH SYNOPSIS
3189249Sru.B grodvi
3289249Sru[
3389249Sru.B \-dv
3489249Sru] [
3589249Sru.BI \-w n
3689249Sru] [
3789249Sru.BI \-F dir
3875592Sru] [
3989249Sru.IR files \|.\|.\|.
4075592Sru]
4175592Sru.PP
4275592SruIt is possible to have whitespace between a command line option and its
4375592Sruparameter.
4475592Sru.SH DESCRIPTION
4575592Sru.B grodvi
4675592Sruis a driver for
4775592Sru.B groff
4875592Sruthat produces \*(tx dvi format.
4975592SruNormally it should be run by
5075592Sru.BR groff\ \-Tdvi .
5175592SruThis will run
5275592Sru.BR @g@troff\ \-Tdvi ;
5375592Sruit will also input the macros
5475592Sru.BR @MACRODIR@/dvi.tmac ;
5575592Sruif the input is being preprocessed with
5675592Sru.B @g@eqn
5775592Sruit will also input
5875592Sru.BR @FONTDIR@/devdvi/eqnchar .
5975592Sru.LP
6075592SruThe dvi file generated by
6175592Sru.B grodvi
6275592Srucan be printed by any correctly-written dvi driver.
6375592SruThe troff drawing primitives are implemented
6475592Sruusing the tpic version 2 specials.
65120302SruIf the driver does not support these, the
6675592Sru.B \eD
6775592Srucommands will not produce any output.
6875592Sru.LP
6975592SruThere is an additional drawing command available:
7075592Sru.TP
7175592Sru.BI \eD'R\  dh\ dv '
7275592SruDraw a rule (solid black rectangle), with one corner
7375592Sruat the current position, and the diagonally opposite corner
7489252Sruat the current position 
7575592Sru.RI +( dh , dv ).
7675592SruAfterwards the current position will be at the opposite corner.  This
7775592Sruproduces a rule in the dvi file and so can be printed even with a
7875592Srudriver that does not support the tpic specials unlike the other
7975592Sru.B \eD
80120301Srucommands.
81120301Sru.LP
8275592SruThe groff command
83120301Sru.BI \eX' anything '
8475592Sruis translated into the same command in the dvi file as would be
8575592Sruproduced by
86119930Sru.BI \especial{ anything }
8775592Sruin \*(tx;
8875592Sru.I anything may not contain a newline.
8975592Sru.LP
9075592SruFont files for
9175592Sru.B grodvi
92120301Srucan be created from tfm files using
93120301Sru.BR tfmtodit (@MAN1EXT@).
9475592SruThe font description file should contain the following
9575592Sruadditional commands:
9688043Sru.Tp \w'\fBinternalname'u+2n
9775592Sru.BI internalname\   name
98120301SruThe name of the tfm file (without the
9975592Sru.B .tfm
10075592Sruextension) is
101118480Sru.IR name .
102120301Sru.TP
103104178Sru.BI checksum\  n
10475592SruThe checksum in the tfm file is
10575592Sru.IR n .
10675592Sru.TP
10775592Sru.BI designsize\  n
10875592SruThe designsize in the tfm file is
10981685Sru.IR n .
11081685Sru.LP
11181685SruThese are automatically generated by
11281685Sru.B tfmtodit.
11381685Sru.LP
11475592SruIn
11581685Sru.B troff
11681685Sruthe
11781685Sru.B \eN
11881685Sruescape sequence can be used to access characters by their position
11981685Sruin the corresponding tfm file;
12081685Sruall characters in the tfm file can be accessed this way.
12181685Sru.SH OPTIONS
12281685Sru.TP
12381685Sru.B \-d
12481685SruDo not use tpic specials to implement drawing commands.
12581685SruHorizontal and vertical lines will be implemented by rules.
12681685SruOther drawing commands will be ignored.
127101476Sru.TP
128101476Sru.B \-v
129101476SruPrint the version number.
130101476Sru.TP
131101476Sru.BI \-w n
132101476SruSet the default line thickness to
133101476Sru.I n
134101476Sruthousandths of an em. 
135101476Sru.TP
13675592Sru.BI \-F dir
13775592SruPrepend directory
13875592Sru.IB dir /devdvi
13975592Sruto the search path for font and device description files.
14075592Sru.SH FILES
141.TP
142.B @FONTDIR@/devdvi/DESC
143Device description file.
144.TP
145.BI @FONTDIR@/devdvi/ F
146Font description file for font
147.IR F .
148.TP
149.B @MACRODIR@/dvi.tmac
150Macros for use with
151.BR grodvi .
152.SH BUGS
153Dvi files produced by
154.B grodvi
155use a different resolution (57816 units per inch) to those produced by
156\*(tx.
157Incorrectly written drivers which assume the resolution used by \*(tx,
158rather than using the resolution specified in the dvi file will not
159work with
160.BR grodvi .
161.LP
162When using the
163.B \-d
164option with boxed tables,
165vertical and horizontal lines can sometimes protrude by one pixel.
166This is a consequence of the way \*(tx requires that the heights
167and widths of rules be rounded.
168.SH "SEE ALSO"
169.BR tfmtodit (@MAN1EXT@),
170.BR groff (@MAN1EXT@),
171.BR @g@troff (@MAN1EXT@),
172.BR groff_out (@MAN5EXT@),
173.BR groff_font (@MAN5EXT@),
174.BR groff_char (@MAN7EXT@)
175.
176.\" Local Variables:
177.\" mode: nroff
178.\" End:
179