|
|
1.1 ! root 1: .TH TEX 1 ! 2: .CT 1 writing_other ! 3: .SH NAME ! 4: tex, initex, virtex, dvips, dvit \- text formatting and typesetting ! 5: .SH SYNOPSIS ! 6: .B tex ! 7: [ ! 8: .L -t ! 9: ] ! 10: [ ! 11: .I first-line ! 12: ] ! 13: .PP ! 14: .B initex ! 15: [ ! 16: .I first-line ! 17: ] ! 18: .PP ! 19: .B virtex ! 20: [ ! 21: .I first-line ! 22: ] ! 23: .PP ! 24: .B dvips ! 25: [ ! 26: .I option ... ! 27: ] ! 28: .I dvifile ! 29: .PP ! 30: .B dvit ! 31: [ ! 32: .I option ... ! 33: ] ! 34: .I dvifile ! 35: .SH DESCRIPTION ! 36: .I Tex ! 37: formats interspersed text and commands ! 38: and outputs a ! 39: .L .dvi ! 40: (`device independent') file. ! 41: .PP ! 42: An argument given on the command line ! 43: behaves as the first input line. ! 44: That line should begin with a (possibly truncated) file name ! 45: or a ! 46: .LR \econtrolsequence . ! 47: Thus ! 48: .L tex paper ! 49: processes the file ! 50: .LR paper.tex . ! 51: The basename of ! 52: .L paper ! 53: becomes the ! 54: .IR jobname , ! 55: and is used in forming output file names. ! 56: If no file is named, the jobname is ! 57: .LR texput . ! 58: The default ! 59: .L .tex ! 60: extension can be overridden by specifying an extension explicitly. ! 61: .PP ! 62: The output is written on ! 63: .IB jobname .dvi , ! 64: which can be printed using ! 65: .IR lp (1). ! 66: A log of error messages goes into ! 67: .IB jobname .log. ! 68: .PP ! 69: As well as the standard TeX fonts, many ! 70: .I Postscript ! 71: fonts can be used ! 72: (see the contents of ! 73: .FR /usr/lib/tex/fonts ). ! 74: To use Times Roman fonts instead of Computer Modern, ! 75: use the ! 76: .L -t ! 77: option. ! 78: The file ! 79: .F testfont.tex ! 80: (in the standard macro directory) will print a table of any font. ! 81: .PP ! 82: These environment variables adjust the behavior of ! 83: .IR tex : ! 84: .TF TEXINPUTS ! 85: .TP ! 86: .B TEXINPUTS ! 87: Search path for ! 88: .L \einput ! 89: and ! 90: .L \eopenin ! 91: files. ! 92: It should be colon-separated, ! 93: and start with dot. ! 94: Default: ! 95: .L .:/usr/lib/tex/macros ! 96: .TP ! 97: .B TEXFONTS ! 98: Search path for font metric files. ! 99: Default: ! 100: .F /usr/lib/tex/fonts ! 101: .TP ! 102: .B TEXFORMATS ! 103: Search path for format files. ! 104: Default: ! 105: .F /usr/lib/tex/macros ! 106: .TP ! 107: .B TEXPOOL ! 108: Search path for strings. ! 109: Default: ! 110: .B /usr/lib/tex ! 111: .PD ! 112: .PP ! 113: .I Initex ! 114: and ! 115: .I virtex ! 116: provide customized versions of ! 117: .I tex. ! 118: .I Initex ! 119: creates a format ! 120: .RB ( .fmt ) ! 121: file that permits fast loading of fonts and macro packages. ! 122: The command ! 123: .LR \edump , ! 124: issued after fonts and definitions have been processed, ! 125: will initialize the file. ! 126: The format file is used by ! 127: .I virtex, ! 128: which requires a format file name preceded by ! 129: .L & ! 130: as the first thing it reads. ! 131: .PP ! 132: .I Dvips ! 133: and ! 134: .I dvit ! 135: convert ! 136: .L .dvi ! 137: files to Postscript ! 138: and ! 139: .I troff ! 140: output format, respectively, ! 141: writing the result on standard output. ! 142: They are invoked by ! 143: .IR lp (1) ! 144: and accept a subset of ! 145: .I lp ! 146: options that make sense for ! 147: .L .dvi ! 148: files. ! 149: In addition, they accept a ! 150: .BI -T dev ! 151: option, where ! 152: .I dev ! 153: is one of ! 154: .L laserwriter ! 155: (default for ! 156: .IR dvips ), ! 157: .L jerq ! 158: (default for ! 159: .IR dvit ), ! 160: .LR gnot , ! 161: .LR imagen , ! 162: or ! 163: .L lino ! 164: (the computer center's high resolution Postscript service). ! 165: The ! 166: .L -Tjerq ! 167: or ! 168: .L -Tgnot ! 169: options should be used for preparing output for ! 170: .IR proof (9.1) ! 171: or ! 172: .IR psi (9.1). ! 173: .PP ! 174: .I Dvips ! 175: and ! 176: .I dvit ! 177: understands some extended graphics commands that can be output using ! 178: .I "tpic specials" ! 179: in the TeX source. ! 180: Many of them work by building up a path of ! 181: .I x,y ! 182: pairs, and then doing something with the path. ! 183: The tpic coordinate system has its origin at the current dvi position ! 184: when a drawing special is emitted; ! 185: all length arguments are in units of milli-inches, ! 186: and the y-axis goes positive downward. ! 187: .TP ! 188: .BI "\especial{pa " "x y" } ! 189: Add ! 190: .I x,y ! 191: to the current path. ! 192: .TP ! 193: .B "\especial{fp} ! 194: Flush the current path: draw it as a polygonal line and reset the path ! 195: to be empty. ! 196: .TP ! 197: .BI "\especial{da " dlen } ! 198: Like ! 199: .B fp ! 200: but draw dashed line, with dashes ! 201: .I dlen ! 202: milli-inches long. ! 203: .TP ! 204: .BI "\especial{dt " slen } ! 205: Like ! 206: .B fp ! 207: but draw a dotted line, with dots ! 208: .I slen ! 209: apart. ! 210: .TP ! 211: .B "\especial{sp}" ! 212: Like ! 213: .B fp ! 214: but draw a quadratic spline. The spline goes through the midpoints of the ! 215: segments of the path, and straight pieces extend it to the endpoints. ! 216: .TP ! 217: .BI "\especial{ar " "x y xr yr s e" } ! 218: Draw a circular or elliptical arc with center at ! 219: .I x,y ! 220: and radii ! 221: .IR xr " and " yr . ! 222: The arc goes clockwise from angle ! 223: .I s ! 224: to angle ! 225: .I e ! 226: (angles measured clockwise from the positive x-axis). ! 227: .TP ! 228: .BI "\especial{pn " n } ! 229: Set line width (pen diameter) to ! 230: .IR n milli-inches. ! 231: .TP ! 232: .B "\especial{bk}" ! 233: Set shading to black (will fill the next object drawn with black). ! 234: .TP ! 235: .B "\especial{sh}" ! 236: Set shading to grey. ! 237: .TP ! 238: .B "\especial{wh}" ! 239: Set shading to white. ! 240: .TP ! 241: .BI "\especial{psfile=" "file options" } ! 242: (Only ! 243: .IR dvips ). ! 244: Include ! 245: .IR file , ! 246: which should be a Postscript illustration, ! 247: making its origin be the current dvi position. ! 248: The default Postscript transformation matrix will be in effect, ! 249: but it can be modified by the ! 250: .IR options , ! 251: a list of ! 252: .IR key = value ! 253: assignments. ! 254: Allowed keys are: ! 255: hoffset, voffset, hscale, vscale, and rotate. ! 256: If supplied, these values are supplied to Postscript ! 257: .IR translate , scale ", and " rotate" ! 258: commands, in that order. ! 259: Also, keys hsize and vsize may be supplied, to cause clipping to ! 260: those sizes. ! 261: .TP ! 262: .BI \especial{include " horg yorg file" } ! 263: (Only ! 264: .IR dvit ). ! 265: Include the ! 266: .IR troff (1) ! 267: output ! 268: .I file ! 269: at the current place on TeX's page. ! 270: The included file should have only one page. ! 271: The ! 272: .I horg ! 273: and ! 274: .I yorg ! 275: distances give the origin of the included file; ! 276: that point will be superimposed on the current position. ! 277: .PP ! 278: All of the specials leave TeX at the same position on the page that ! 279: it started in. ! 280: .SH FILES ! 281: .TF /usr/lib/tex/macros/doc/* ! 282: .TP ! 283: .F /usr/lib/tex/macros/* ! 284: macros and preloaded format files ! 285: .TP ! 286: .F /usr/lib/tex/macros/doc/* ! 287: more TeX-related documentation ! 288: .TP ! 289: .F /usr/lib/tex/fonts/* ! 290: font metrics and bitmaps ! 291: .TP ! 292: .F /usr/lib/tex/* ! 293: miscellaneous configuration files and Postscript headers ! 294: .SH "SEE ALSO" ! 295: .IR latex (6), ! 296: .IR pic (1), ! 297: .IR lp (1), ! 298: .IR proof (9.1), ! 299: .IR psi (9.1), ! 300: .IR troff (1), ! 301: .IR monk (1) ! 302: .br ! 303: Donald E. Knuth, ! 304: .I The TEXbook, ! 305: Addison Wesley, 1986 ! 306: .SH BUGS ! 307: It should be possible to make TeX output go on standard output. ! 308:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.