grodvi.man revision 151497
179543Sru.ig 2151497SruCopyright (C) 1989-2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc. 375584Sru 475584SruPermission is granted to make and distribute verbatim copies of 575584Sruthis manual provided the copyright notice and this permission notice 675584Sruare preserved on all copies. 775584Sru 875584SruPermission is granted to copy and distribute modified versions of this 975584Srumanual under the conditions for verbatim copying, provided that the 1075584Sruentire resulting derived work is distributed under the terms of a 1175584Srupermission notice identical to this one. 1275584Sru 1375584SruPermission is granted to copy and distribute translations of this 1475584Srumanual into another language, under the above conditions for modified 1575584Sruversions, except that this permission notice may be included in 1675584Srutranslations approved by the Free Software Foundation instead of in 1775584Sruthe original English. 1875584Sru.. 19104862Sru. 20151497Sru.do nr grodvi_C \n[.C] 21151497Sru.cp 0 22104862Sru. 2375584Sru.ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X 2475584Sru.el .ds tx TeX 25114402Sru. 2675584Sru.\" Like TP, but if specified indent is more than half 2775584Sru.\" the current line-length - indent, use the default indent. 2875584Sru.de Tp 29114402Sru. ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP 30114402Sru. el .TP "\\$1" 3175584Sru.. 32104862Sru. 33114402Sru.de TQ 34114402Sru. br 35114402Sru. ns 36114402Sru. TP \$1 37114402Sru.. 38104862Sru. 39114402Sru.de FT 40114402Sru. if '\\*(.T'dvi' .ft \\$1 41114402Sru.. 42114402Sru. 43114402Sru. 4475584Sru.TH GRODVI @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" 4575584Sru.SH NAME 4675584Srugrodvi \- convert groff output to TeX dvi format 47104862Sru. 48104862Sru. 4975584Sru.SH SYNOPSIS 5075584Sru.B grodvi 5175584Sru[ 52114402Sru.B \-dlv 5375584Sru] [ 54114402Sru.BI \-F dir 55114402Sru] [ 56114402Sru.BI \-p papersize 57114402Sru] [ 5875584Sru.BI \-w n 5975584Sru] [ 60104862Sru.IR files \|.\|.\|.\& 6175584Sru] 6275584Sru.PP 6375584SruIt is possible to have whitespace between a command line option and its 6475584Sruparameter. 65104862Sru. 66104862Sru. 6775584Sru.SH DESCRIPTION 6875584Sru.B grodvi 6975584Sruis a driver for 7075584Sru.B groff 7175584Sruthat produces \*(tx dvi format. 72104862Sru. 7375584SruNormally it should be run by 7475584Sru.BR groff\ \-Tdvi . 75104862Sru. 7675584SruThis will run 7775584Sru.BR @g@troff\ \-Tdvi ; 78114402Sruit will also input the macros in 79114402Sru.BR @MACRODIR@/dvi.tmac . 80104862Sru. 8175584Sru.LP 8275584SruThe dvi file generated by 8375584Sru.B grodvi 8475584Srucan be printed by any correctly-written dvi driver. 85104862Sru. 8675584SruThe troff drawing primitives are implemented 87104862Sruusing the tpic version\~2 specials. 88104862Sru. 8975584SruIf the driver does not support these, the 90104862Sru.B \[rs]D 9175584Srucommands will not produce any output. 92104862Sru. 9375584Sru.LP 9475584SruThere is an additional drawing command available: 95104862Sru. 9675584Sru.TP 97104862Sru.BI \[rs]D'R\ dh\ dv ' 9875584SruDraw a rule (solid black rectangle), with one corner 9975584Sruat the current position, and the diagonally opposite corner 100104862Sruat the current position 10175584Sru.RI +( dh , dv ). 102104862Sru. 103104862SruAfterwards the current position will be at the opposite corner. 104104862Sru. 105104862SruThis produces a rule in the dvi file and so can be printed even with a 10675584Srudriver that does not support the tpic specials unlike the other 107104862Sru.B \[rs]D 10875584Srucommands. 109104862Sru. 11075584Sru.LP 11175584SruThe groff command 112104862Sru.BI \[rs]X' anything ' 11375584Sruis translated into the same command in the dvi file as would be 11475584Sruproduced by 115104862Sru.BI \[rs]special{ anything } 11675584Sruin \*(tx; 117104862Sru.I anything 118104862Srumay not contain a newline. 119104862Sru. 12075584Sru.LP 121104862SruFor inclusion of EPS image files, 122151497Sru.B \-Tdvi 123104862Sruloads 124104862Sru.B pspic.tmac 125104862Sruautomatically, providing the 126104862Sru.B PSPIC 127104862Srumacro. 128104862Sru. 129104862SruPlease check 130114402Sru.BR groff_tmac (@MAN5EXT@) 131114402Srufor a detailed description. 132104862Sru. 133104862Sru.LP 13475584SruFont files for 13575584Sru.B grodvi 13675584Srucan be created from tfm files using 13775584Sru.BR tfmtodit (@MAN1EXT@). 138104862Sru. 13975584SruThe font description file should contain the following 14075584Sruadditional commands: 141104862Sru. 14275584Sru.Tp \w'\fBinternalname'u+2n 14375584Sru.BI internalname\ name 14475584SruThe name of the tfm file (without the 14575584Sru.B .tfm 14675584Sruextension) is 14775584Sru.IR name . 148104862Sru. 14975584Sru.TP 15075584Sru.BI checksum\ n 15175584SruThe checksum in the tfm file is 15275584Sru.IR n . 153104862Sru. 15475584Sru.TP 15575584Sru.BI designsize\ n 15675584SruThe designsize in the tfm file is 15775584Sru.IR n . 158104862Sru. 15975584Sru.LP 16075584SruThese are automatically generated by 16175584Sru.B tfmtodit. 162104862Sru. 16375584Sru.LP 164104862SruThe default color for 165104862Sru.B \[rs]m 166104862Sruand 167104862Sru.B \[rs]M 168104862Sruis black. 169104862Sru. 170104862SruCurrently, the drawing color for 171104862Sru.B \[rs]D 172104862Srucommands is always black, and fill color values are translated to gray. 173104862Sru. 174104862Sru.LP 17575584SruIn 17675584Sru.B troff 17775584Sruthe 178104862Sru.B \[rs]N 17975584Sruescape sequence can be used to access characters by their position 18075584Sruin the corresponding tfm file; 18175584Sruall characters in the tfm file can be accessed this way. 182104862Sru. 183114402Sru.LP 184114402SruBy design, the DVI format doesn't care about physical dimensions of the 185114402Sruoutput medium. 186104862Sru. 187114402SruInstead, 188114402Sru.B grodvi 189114402Sruemits the equivalent to \*(tx's 190114402Sru.BI \[rs]special{papersize= width , length } 191114402Sruon the first page; 192114402Sru.B dvips 193114402Sru(and possibly other DVI drivers) then sets the page size accordingly. 194114402Sru. 195114402SruIf either the page width or length is not positive, no papersize special 196114402Sruis output. 197114402Sru. 198114402Sru. 19975584Sru.SH OPTIONS 20075584Sru.TP 20175584Sru.B \-d 20275584SruDo not use tpic specials to implement drawing commands. 203104862Sru. 20475584SruHorizontal and vertical lines will be implemented by rules. 205104862Sru. 20675584SruOther drawing commands will be ignored. 207104862Sru. 20875584Sru.TP 209114402Sru.BI \-F dir 210114402SruPrepend directory 211114402Sru.IB dir /dev name 212114402Sruto the search path for font and device description files; 213114402Sru.I name 214114402Sruis the name of the device, usually 215114402Sru.BR dvi . 216114402Sru. 217114402Sru.TP 218114402Sru.B \-l 219114402SruSpecify landscape orientation. 220114402Sru. 221114402Sru.TP 222114402Sru.BI \-p papersize 223114402SruSpecify paper dimensions. 224114402Sru. 225114402SruThis overrides the 226114402Sru.BR papersize , 227114402Sru.BR paperlength , 228114402Sruand 229114402Sru.B paperwidth 230114402Srucommands in the 231114402Sru.B DESC 232114402Srufile; it accepts the same arguments as the 233114402Sru.B papersize 234114402Srucommand (see 235114402Sru.BR groff_font (@MAN5EXT@) 236114402Srufor details). 237114402Sru. 238114402Sru.TP 23975584Sru.B \-v 24075584SruPrint the version number. 241104862Sru. 24275584Sru.TP 24375584Sru.BI \-w n 24475584SruSet the default line thickness to 24575584Sru.I n 246104862Sruthousandths of an em. 247104862SruIf this option isn't specified, the line thickness defaults to 0.04\~em. 248104862Sru. 249104862Sru. 250104862Sru.SH USAGE 251104862SruThere are styles called 252104862Sru.BR R , 253104862Sru.BR I , 254104862Sru.BR B , 255104862Sruand 256104862Sru.B BI 257114402Srumounted at font positions 1 to\ 4. 258104862SruThe fonts are grouped into families 259104862Sru.B T 260104862Sruand 261114402Sru.B H\ \c 262104862Sruhaving members in each of these styles: 263104862Sru. 264104862Sru.RS 265104862Sru.TP 266104862Sru.B TR 267104862Sru.FT TR 268104862SruCM Roman (cmr10) 269104862Sru.FT 270104862Sru. 271114402Sru.TQ 272104862Sru.B TI 273104862Sru.FT TI 274104862SruCM Text Italic (cmti10) 275104862Sru.FT 276104862Sru. 277114402Sru.TQ 278104862Sru.B TB 279104862Sru.FT TB 280104862SruCM Bold Extended Roman (cmbx10) 281104862Sru.FT 282104862Sru. 283114402Sru.TQ 284104862Sru.B TBI 285104862Sru.FT TBI 286104862SruCM Bold Extended Text Italic (cmbxti10) 287104862Sru.FT 288104862Sru. 289114402Sru.TQ 290104862Sru.B HR 291104862Sru.FT HR 292104862SruCM Sans Serif (cmss10) 293104862Sru.FT 294104862Sru. 295114402Sru.TQ 296104862Sru.B HI 297104862Sru.FT HI 298104862SruCM Slanted Sans Serif (cmssi10) 299104862Sru.FT 300104862Sru. 301114402Sru.TQ 302104862Sru.B HB 303104862Sru.FT HB 304104862SruCM Sans Serif Bold Extended (cmssbx10) 305104862Sru.FT 306104862Sru. 307114402Sru.TQ 308104862Sru.B HBI 309104862Sru.FT HBI 310104862SruCM Slanted Sans Serif Bold Extended (cmssbxo10) 311104862Sru.FT 312104862Sru.RE 313104862Sru. 314104862Sru.LP 315104862SruThere are also the following fonts which are not members of a family: 316104862Sru. 317104862Sru.RS 318104862Sru.TP 319104862Sru.B CW 320104862SruCM Typewriter Text (cmtt10) 321104862Sru.FT CW 322104862Sru.FT 323104862Sru. 324114402Sru.TQ 325104862Sru.B CWI 326104862SruCM Italic Typewriter Text (cmitt10) 327104862Sru.FT CWI 328104862Sru.FT 329104862Sru.RE 330104862Sru. 331104862Sru.LP 332104862SruSpecial fonts are 333104862Sru.B MI 334104862Sru(cmmi10), 335104862Sru.B S 336104862Sru(cmsy10), 337104862Sru.B EX 338104862Sru(cmex10), 339114402Sru.B SC 340114402Sru(cmtex10, only for 341114402Sru.BR CW ), 342104862Sruand, perhaps surprisingly, 343104862Sru.BR TR , 344104862Sru.BR TI , 345104862Sruand 346104862Sru.BR CW , 347104862Srudue to the different font encodings of text fonts. 348104862Sru. 349104862SruFor italic fonts, 350104862Sru.B CWI 351104862Sruis used instead of 352104862Sru.BR CW . 353104862Sru. 354104862Sru.LP 355104862SruFinally, the symbol fonts of the American Mathematical Society are available 356104862Sruas special fonts 357104862Sru.B SA 358104862Sru(msam10) and 359104862Sru.B SB 360104862Sru(msbm10). 361104862Sru. 362104862SruThese two fonts are not mounted by default. 363104862Sru. 364104862Sru.LP 365104862SruUsing the option 366104862Sru.B \-mec 367114402Sru(which loads the file 368104862Sru.BR ec.tmac ) 369114402Sruprovides the EC and TC fonts. 370104862Sru. 371104862SruThe design of the EC family is very similar to that of the CM fonts; 372104862Sruadditionally, they give a much better coverage of groff symbols. 373104862Sru. 374104862SruNote that 375104862Sru.B ec.tmac 376104862Srumust be called before any language-specific files; it doesn't take care of 377104862Sruhcode values. 378104862Sru. 379104862Sru. 38075584Sru.SH FILES 38175584Sru.TP 38275584Sru.B @FONTDIR@/devdvi/DESC 38375584SruDevice description file. 384104862Sru. 38575584Sru.TP 38675584Sru.BI @FONTDIR@/devdvi/ F 38775584SruFont description file for font 38875584Sru.IR F . 389104862Sru. 39075584Sru.TP 39175584Sru.B @MACRODIR@/dvi.tmac 39275584SruMacros for use with 39375584Sru.BR grodvi . 394104862Sru. 395104862Sru.TP 396104862Sru.B @MACRODIR@/ec.tmac 397104862SruMacros to switch to EC fonts. 398104862Sru. 399104862Sru. 40075584Sru.SH BUGS 40175584SruDvi files produced by 40275584Sru.B grodvi 40375584Sruuse a different resolution (57816 units per inch) to those produced by 40475584Sru\*(tx. 405104862Sru. 40675584SruIncorrectly written drivers which assume the resolution used by \*(tx, 40775584Srurather than using the resolution specified in the dvi file will not 40875584Sruwork with 40975584Sru.BR grodvi . 410104862Sru. 41175584Sru.LP 41275584SruWhen using the 41375584Sru.B \-d 41475584Sruoption with boxed tables, 41575584Sruvertical and horizontal lines can sometimes protrude by one pixel. 416104862Sru. 41775584SruThis is a consequence of the way \*(tx requires that the heights 41875584Sruand widths of rules be rounded. 419104862Sru. 420104862Sru. 42175584Sru.SH "SEE ALSO" 42275584Sru.BR tfmtodit (@MAN1EXT@), 42375584Sru.BR groff (@MAN1EXT@), 42475584Sru.BR @g@troff (@MAN1EXT@), 42575584Sru.BR groff_out (@MAN5EXT@), 42675584Sru.BR groff_font (@MAN5EXT@), 427114402Sru.BR groff_char (@MAN7EXT@), 428114402Sru.BR groff_tmac (@MAN5EXT@) 42979543Sru. 430151497Sru.cp \n[grodvi_C] 431151497Sru. 43279543Sru.\" Local Variables: 43379543Sru.\" mode: nroff 43479543Sru.\" End: 435