grodvi.man revision 114402
1.ig 2Copyright (C) 1989-2000, 2001, 2002, 2003 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. 20. 21.ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X 22.el .ds tx TeX 23. 24.\" Like TP, but if specified indent is more than half 25.\" the current line-length - indent, use the default indent. 26.de Tp 27. ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP 28. el .TP "\\$1" 29.. 30. 31.de TQ 32. br 33. ns 34. TP \$1 35.. 36. 37.de FT 38. if '\\*(.T'dvi' .ft \\$1 39.. 40. 41. 42.TH GRODVI @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" 43.SH NAME 44grodvi \- convert groff output to TeX dvi format 45. 46. 47.SH SYNOPSIS 48.B grodvi 49[ 50.B \-dlv 51] [ 52.BI \-F dir 53] [ 54.BI \-p papersize 55] [ 56.BI \-w n 57] [ 58.IR files \|.\|.\|.\& 59] 60.PP 61It is possible to have whitespace between a command line option and its 62parameter. 63. 64. 65.SH DESCRIPTION 66.B grodvi 67is a driver for 68.B groff 69that produces \*(tx dvi format. 70. 71Normally it should be run by 72.BR groff\ \-Tdvi . 73. 74This will run 75.BR @g@troff\ \-Tdvi ; 76it will also input the macros in 77.BR @MACRODIR@/dvi.tmac . 78. 79.LP 80The dvi file generated by 81.B grodvi 82can be printed by any correctly-written dvi driver. 83. 84The troff drawing primitives are implemented 85using the tpic version\~2 specials. 86. 87If the driver does not support these, the 88.B \[rs]D 89commands will not produce any output. 90. 91.LP 92There is an additional drawing command available: 93. 94.TP 95.BI \[rs]D'R\ dh\ dv ' 96Draw a rule (solid black rectangle), with one corner 97at the current position, and the diagonally opposite corner 98at the current position 99.RI +( dh , dv ). 100. 101Afterwards the current position will be at the opposite corner. 102. 103This produces a rule in the dvi file and so can be printed even with a 104driver that does not support the tpic specials unlike the other 105.B \[rs]D 106commands. 107. 108.LP 109The groff command 110.BI \[rs]X' anything ' 111is translated into the same command in the dvi file as would be 112produced by 113.BI \[rs]special{ anything } 114in \*(tx; 115.I anything 116may not contain a newline. 117. 118.LP 119For inclusion of EPS image files, 120.B grodvi 121loads 122.B pspic.tmac 123automatically, providing the 124.B PSPIC 125macro. 126. 127Please check 128.BR groff_tmac (@MAN5EXT@) 129for a detailed description. 130. 131.LP 132Font files for 133.B grodvi 134can be created from tfm files using 135.BR tfmtodit (@MAN1EXT@). 136. 137The font description file should contain the following 138additional commands: 139. 140.Tp \w'\fBinternalname'u+2n 141.BI internalname\ name 142The name of the tfm file (without the 143.B .tfm 144extension) is 145.IR name . 146. 147.TP 148.BI checksum\ n 149The checksum in the tfm file is 150.IR n . 151. 152.TP 153.BI designsize\ n 154The designsize in the tfm file is 155.IR n . 156. 157.LP 158These are automatically generated by 159.B tfmtodit. 160. 161.LP 162The default color for 163.B \[rs]m 164and 165.B \[rs]M 166is black. 167. 168Currently, the drawing color for 169.B \[rs]D 170commands is always black, and fill color values are translated to gray. 171. 172.LP 173In 174.B troff 175the 176.B \[rs]N 177escape sequence can be used to access characters by their position 178in the corresponding tfm file; 179all characters in the tfm file can be accessed this way. 180. 181.LP 182By design, the DVI format doesn't care about physical dimensions of the 183output medium. 184. 185Instead, 186.B grodvi 187emits the equivalent to \*(tx's 188.BI \[rs]special{papersize= width , length } 189on the first page; 190.B dvips 191(and possibly other DVI drivers) then sets the page size accordingly. 192. 193If either the page width or length is not positive, no papersize special 194is output. 195. 196. 197.SH OPTIONS 198.TP 199.B \-d 200Do not use tpic specials to implement drawing commands. 201. 202Horizontal and vertical lines will be implemented by rules. 203. 204Other drawing commands will be ignored. 205. 206.TP 207.BI \-F dir 208Prepend directory 209.IB dir /dev name 210to the search path for font and device description files; 211.I name 212is the name of the device, usually 213.BR dvi . 214. 215.TP 216.B \-l 217Specify landscape orientation. 218. 219.TP 220.BI \-p papersize 221Specify paper dimensions. 222. 223This overrides the 224.BR papersize , 225.BR paperlength , 226and 227.B paperwidth 228commands in the 229.B DESC 230file; it accepts the same arguments as the 231.B papersize 232command (see 233.BR groff_font (@MAN5EXT@) 234for details). 235. 236.TP 237.B \-v 238Print the version number. 239. 240.TP 241.BI \-w n 242Set the default line thickness to 243.I n 244thousandths of an em. 245If this option isn't specified, the line thickness defaults to 0.04\~em. 246. 247. 248.SH USAGE 249There are styles called 250.BR R , 251.BR I , 252.BR B , 253and 254.B BI 255mounted at font positions 1 to\ 4. 256The fonts are grouped into families 257.B T 258and 259.B H\ \c 260having members in each of these styles: 261. 262.RS 263.TP 264.B TR 265.FT TR 266CM Roman (cmr10) 267.FT 268. 269.TQ 270.B TI 271.FT TI 272CM Text Italic (cmti10) 273.FT 274. 275.TQ 276.B TB 277.FT TB 278CM Bold Extended Roman (cmbx10) 279.FT 280. 281.TQ 282.B TBI 283.FT TBI 284CM Bold Extended Text Italic (cmbxti10) 285.FT 286. 287.TQ 288.B HR 289.FT HR 290CM Sans Serif (cmss10) 291.FT 292. 293.TQ 294.B HI 295.FT HI 296CM Slanted Sans Serif (cmssi10) 297.FT 298. 299.TQ 300.B HB 301.FT HB 302CM Sans Serif Bold Extended (cmssbx10) 303.FT 304. 305.TQ 306.B HBI 307.FT HBI 308CM Slanted Sans Serif Bold Extended (cmssbxo10) 309.FT 310.RE 311. 312.LP 313There are also the following fonts which are not members of a family: 314. 315.RS 316.TP 317.B CW 318CM Typewriter Text (cmtt10) 319.FT CW 320.FT 321. 322.TQ 323.B CWI 324CM Italic Typewriter Text (cmitt10) 325.FT CWI 326.FT 327.RE 328. 329.LP 330Special fonts are 331.B MI 332(cmmi10), 333.B S 334(cmsy10), 335.B EX 336(cmex10), 337.B SC 338(cmtex10, only for 339.BR CW ), 340and, perhaps surprisingly, 341.BR TR , 342.BR TI , 343and 344.BR CW , 345due to the different font encodings of text fonts. 346. 347For italic fonts, 348.B CWI 349is used instead of 350.BR CW . 351. 352.LP 353Finally, the symbol fonts of the American Mathematical Society are available 354as special fonts 355.B SA 356(msam10) and 357.B SB 358(msbm10). 359. 360These two fonts are not mounted by default. 361. 362.LP 363Using the option 364.B \-mec 365(which loads the file 366.BR ec.tmac ) 367provides the EC and TC fonts. 368. 369The design of the EC family is very similar to that of the CM fonts; 370additionally, they give a much better coverage of groff symbols. 371. 372Note that 373.B ec.tmac 374must be called before any language-specific files; it doesn't take care of 375hcode values. 376. 377. 378.SH FILES 379.TP 380.B @FONTDIR@/devdvi/DESC 381Device description file. 382. 383.TP 384.BI @FONTDIR@/devdvi/ F 385Font description file for font 386.IR F . 387. 388.TP 389.B @MACRODIR@/dvi.tmac 390Macros for use with 391.BR grodvi . 392. 393.TP 394.B @MACRODIR@/ec.tmac 395Macros to switch to EC fonts. 396. 397. 398.SH BUGS 399Dvi files produced by 400.B grodvi 401use a different resolution (57816 units per inch) to those produced by 402\*(tx. 403. 404Incorrectly written drivers which assume the resolution used by \*(tx, 405rather than using the resolution specified in the dvi file will not 406work with 407.BR grodvi . 408. 409.LP 410When using the 411.B \-d 412option with boxed tables, 413vertical and horizontal lines can sometimes protrude by one pixel. 414. 415This is a consequence of the way \*(tx requires that the heights 416and widths of rules be rounded. 417. 418. 419.SH "SEE ALSO" 420.BR tfmtodit (@MAN1EXT@), 421.BR groff (@MAN1EXT@), 422.BR @g@troff (@MAN1EXT@), 423.BR groff_out (@MAN5EXT@), 424.BR groff_font (@MAN5EXT@), 425.BR groff_char (@MAN7EXT@), 426.BR groff_tmac (@MAN5EXT@) 427. 428.\" Local Variables: 429.\" mode: nroff 430.\" End: 431