grodvi.man revision 79543
1.ig 2Copyright (C) 1989-2000, 2001 Free Software Foundation, Inc. 3 4Permission is granted to make and distribute verbatim copies of 5this manual provided the copyright notice and this permission notice 6are preserved on all copies. 7 8Permission is granted to copy and distribute modified versions of this 9manual under the conditions for verbatim copying, provided that the 10entire resulting derived work is distributed under the terms of a 11permission notice identical to this one. 12 13Permission is granted to copy and distribute translations of this 14manual into another language, under the above conditions for modified 15versions, except that this permission notice may be included in 16translations approved by the Free Software Foundation instead of in 17the original English. 18.. 19.ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X 20.el .ds tx TeX 21.\" Like TP, but if specified indent is more than half 22.\" the current line-length - indent, use the default indent. 23.de Tp 24.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP 25.el .TP "\\$1" 26.. 27.TH GRODVI @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" 28.SH NAME 29grodvi \- convert groff output to TeX dvi format 30.SH SYNOPSIS 31.B grodvi 32[ 33.B \-dv 34] [ 35.BI \-w n 36] [ 37.BI \-F dir 38] [ 39.IR files \|.\|.\|. 40] 41.PP 42It is possible to have whitespace between a command line option and its 43parameter. 44.SH DESCRIPTION 45.B grodvi 46is a driver for 47.B groff 48that produces \*(tx dvi format. 49Normally it should be run by 50.BR groff\ \-Tdvi . 51This will run 52.BR @g@troff\ \-Tdvi ; 53it will also input the macros 54.BR @MACRODIR@/dvi.tmac ; 55if the input is being preprocessed with 56.B @g@eqn 57it will also input 58.BR @FONTDIR@/devdvi/eqnchar . 59.LP 60The dvi file generated by 61.B grodvi 62can be printed by any correctly-written dvi driver. 63The troff drawing primitives are implemented 64using the tpic version 2 specials. 65If the driver does not support these, the 66.B \eD 67commands will not produce any output. 68.LP 69There is an additional drawing command available: 70.TP 71.BI \eD'R\ dh\ dv ' 72Draw a rule (solid black rectangle), with one corner 73at the current position, and the diagonally opposite corner 74at the current position 75.RI +( dh , dv ). 76Afterwards the current position will be at the opposite corner. This 77produces a rule in the dvi file and so can be printed even with a 78driver that does not support the tpic specials unlike the other 79.B \eD 80commands. 81.LP 82The groff command 83.BI \eX' anything ' 84is translated into the same command in the dvi file as would be 85produced by 86.BI \especial{ anything } 87in \*(tx; 88.I anything may not contain a newline. 89.LP 90Font files for 91.B grodvi 92can be created from tfm files using 93.BR tfmtodit (@MAN1EXT@). 94The font description file should contain the following 95additional commands: 96.Tp \w'\fBinternalname'u+2n 97.BI internalname\ name 98The name of the tfm file (without the 99.B .tfm 100extension) is 101.IR name . 102.TP 103.BI checksum\ n 104The checksum in the tfm file is 105.IR n . 106.TP 107.BI designsize\ n 108The designsize in the tfm file is 109.IR n . 110.LP 111These are automatically generated by 112.B tfmtodit. 113.LP 114In 115.B troff 116the 117.B \eN 118escape sequence can be used to access characters by their position 119in the corresponding tfm file; 120all characters in the tfm file can be accessed this way. 121.SH OPTIONS 122.TP 123.B \-d 124Do not use tpic specials to implement drawing commands. 125Horizontal and vertical lines will be implemented by rules. 126Other drawing commands will be ignored. 127.TP 128.B \-v 129Print the version number. 130.TP 131.BI \-w n 132Set the default line thickness to 133.I n 134thousandths of an em. 135.TP 136.BI \-F dir 137Prepend directory 138.IB dir /devdvi 139to the search path for font and device description files. 140.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