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