|
|
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.