grodvi.man revision 75584
10SN/A.ig \"-*- nroff -*- 27577SN/ACopyright (C) 1989-2000 Free Software Foundation, Inc. 30SN/A 40SN/APermission is granted to make and distribute verbatim copies of 50SN/Athis manual provided the copyright notice and this permission notice 60SN/Aare preserved on all copies. 72362SN/A 80SN/APermission is granted to copy and distribute modified versions of this 92362SN/Amanual under the conditions for verbatim copying, provided that the 100SN/Aentire resulting derived work is distributed under the terms of a 110SN/Apermission notice identical to this one. 120SN/A 130SN/APermission is granted to copy and distribute translations of this 140SN/Amanual into another language, under the above conditions for modified 150SN/Aversions, except that this permission notice may be included in 160SN/Atranslations approved by the Free Software Foundation instead of in 170SN/Athe original English. 180SN/A.. 190SN/A.ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X 200SN/A.el .ds tx TeX 212362SN/A.\" Like TP, but if specified indent is more than half 222362SN/A.\" the current line-length - indent, use the default indent. 232362SN/A.de Tp 240SN/A.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP 250SN/A.el .TP "\\$1" 260SN/A.. 270SN/A.TH GRODVI @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" 280SN/A.SH NAME 290SN/Agrodvi \- convert groff output to TeX dvi format 300SN/A.SH SYNOPSIS 310SN/A.B grodvi 320SN/A[ 330SN/A.B \-dv 347577SN/A] [ 350SN/A.BI \-w n 360SN/A] [ 370SN/A.BI \-F dir 380SN/A] [ 390SN/A.IR files \|.\|.\|. 400SN/A] 410SN/A.PP 420SN/AIt is possible to have whitespace between a command line option and its 430SN/Aparameter. 440SN/A.SH DESCRIPTION 450SN/A.B grodvi 4617338Smliis a driver for 470SN/A.B groff 480SN/Athat produces \*(tx dvi format. 490SN/ANormally it should be run by 500SN/A.BR groff\ \-Tdvi . 510SN/AThis will run 520SN/A.BR @g@troff\ \-Tdvi ; 530SN/Ait will also input the macros 540SN/A.BR @MACRODIR@/dvi.tmac ; 550SN/Aif the input is being preprocessed with 560SN/A.B @g@eqn 570SN/Ait will also input 580SN/A.BR @FONTDIR@/devdvi/eqnchar . 590SN/A.LP 600SN/AThe dvi file generated by 610SN/A.B grodvi 620SN/Acan be printed by any correctly-written dvi driver. 630SN/AThe troff drawing primitives are implemented 640SN/Ausing the tpic version 2 specials. 650SN/AIf the driver does not support these, the 660SN/A.B \eD 670SN/Acommands will not produce any output. 680SN/A.LP 690SN/AThere is an additional drawing command available: 700SN/A.TP 710SN/A.BI \eD'R\ dh\ dv ' 720SN/ADraw a rule (solid black rectangle), with one corner 730SN/Aat the current position, and the diagonally opposite corner 740SN/Aat the current position 750SN/A.RI +( dh , dv ). 760SN/AAfterwards the current position will be at the opposite corner. This 770SN/Aproduces a rule in the dvi file and so can be printed even with a 780SN/Adriver that does not support the tpic specials unlike the other 790SN/A.B \eD 800SN/Acommands. 810SN/A.LP 820SN/AThe groff command 830SN/A.BI \eX' anything ' 840SN/Ais translated into the same command in the dvi file as would be 850SN/Aproduced by 860SN/A.BI \especial{ anything } 870SN/Ain \*(tx; 880SN/A.I anything may not contain a newline. 890SN/A.LP 900SN/AFont files for 910SN/A.B grodvi 927577SN/Acan be created from tfm files using 930SN/A.BR tfmtodit (@MAN1EXT@). 940SN/AThe font description file should contain the following 950SN/Aadditional commands: 960SN/A.Tp \w'\fBinternalname'u+2n 970SN/A.BI internalname\ name 987577SN/AThe name of the tfm file (without the 997577SN/A.B .tfm 1000SN/Aextension) is 1010SN/A.IR name . 1020SN/A.TP 1030SN/A.BI checksum\ n 1040SN/AThe checksum in the tfm file is 1050SN/A.IR n . 1060SN/A.TP 1070SN/A.BI designsize\ n 1080SN/AThe designsize in the tfm file is 1090SN/A.IR n . 1100SN/A.LP 1110SN/AThese are automatically generated by 1120SN/A.B tfmtodit. 1130SN/A.LP 1140SN/AIn 1150SN/A.B troff 1160SN/Athe 1170SN/A.B \eN 1180SN/Aescape sequence can be used to access characters by their position 1190SN/Ain the corresponding tfm file; 1200SN/Aall characters in the tfm file can be accessed this way. 1210SN/A.SH OPTIONS 1220SN/A.TP 1230SN/A.B \-d 1240SN/ADo not use tpic specials to implement drawing commands. 1250SN/AHorizontal and vertical lines will be implemented by rules. 1260SN/AOther drawing commands will be ignored. 1270SN/A.TP 1280SN/A.B \-v 1290SN/APrint the version number. 1300SN/A.TP 1310SN/A.BI \-w n 1320SN/ASet the default line thickness to 1330SN/A.I n 1347577SN/Athousandths of an em. 1350SN/A.TP 1360SN/A.BI \-F dir 1370SN/APrepend directory 1380SN/A.IB dir /devdvi 1390SN/Ato the search path for font and device description files. 1400SN/A.SH FILES 1410SN/A.TP 1420SN/A.B @FONTDIR@/devdvi/DESC 1430SN/ADevice description file. 1440SN/A.TP 1450SN/A.BI @FONTDIR@/devdvi/ F 1467577SN/AFont description file for font 1470SN/A.IR F . 1480SN/A.TP 1490SN/A.B @MACRODIR@/dvi.tmac 1500SN/AMacros for use with 1510SN/A.BR grodvi . 1520SN/A.SH BUGS 1530SN/ADvi files produced by 1540SN/A.B grodvi 1550SN/Ause a different resolution (57816 units per inch) to those produced by 1560SN/A\*(tx. 1570SN/AIncorrectly written drivers which assume the resolution used by \*(tx, 1580SN/Arather than using the resolution specified in the dvi file will not 1590SN/Awork with 1600SN/A.BR grodvi . 1610SN/A.LP 1620SN/AWhen using the 1630SN/A.B \-d 1640SN/Aoption with boxed tables, 1650SN/Avertical and horizontal lines can sometimes protrude by one pixel. 1660SN/AThis is a consequence of the way \*(tx requires that the heights 1670SN/Aand widths of rules be rounded. 1680SN/A.SH "SEE ALSO" 1690SN/A.BR tfmtodit (@MAN1EXT@), 1700SN/A.BR groff (@MAN1EXT@), 1710SN/A.BR @g@troff (@MAN1EXT@), 1720SN/A.BR groff_out (@MAN5EXT@), 1730SN/A.BR groff_font (@MAN5EXT@), 1740SN/A.BR groff_char (@MAN7EXT@) 1750SN/A