![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to tex CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Plan 9 NeXT] / lucent / sys / man / 1|
Return to tex CVS log | Up to [Plan 9 NeXT] / lucent / sys / man / 1 |
1.1 root 1: .TH TEX 1
2: .SH NAME
3: tex, latex, bibtex, dvips, dviselect, mf \- text formatting and typesetting
4: .SH SYNOPSIS
5: .B tex
6: [
7: .I first-line
8: ]
9: .PP
10: .B latex
11: .IR file [.tex]
12: .PP
13: .B dvips
14: [
15: .I option ...
16: ]
17: .I dvifile
18: .PP
19: .B dviselect
20: [
21: .B -s
22: ] [
23: .B -i
24: .I infile
25: ] [
26: .B -o
27: .I outfile
28: ]
29: .I "list of pages"
30: [
31: .I infile
32: [
33: .I outfile
34: ] ]
35: .PP
36: .B bibtex
37: .I auxname
38: .PP
39: .B mf
40: [
41: .I first-line
42: ]
43: .SH DESCRIPTION
44: .I Tex
45: formats interspersed text and commands
46: and outputs a
47: .B .dvi
48: (`device independent') file.
49: .PP
50: An argument given on the command line
51: behaves as the first input line.
52: That line should begin with a (possibly truncated) file name
53: or a
54: .IR \econtrolsequence .
55: Thus
56: .B tex paper
57: processes the file
58: .BR paper.tex .
59: The base name of
60: .B paper
61: becomes the
62: .IR jobname ,
63: and is used in forming output file names.
64: If no file is named, the jobname is
65: .BR texput .
66: The default
67: .B .tex
68: extension can be overridden by specifying an extension explicitly.
69: .PP
70: The output is written on
71: .IB jobname .dvi\f1,
72: which can be printed using
73: .IR lp (1).
74: A log of error messages goes into
75: .IB jobname .log\f1.
76: .PP
77: As well as the standard TeX fonts, many PostScript
78: fonts can be used
79: (see the contents of
80: .BR /sys/lib/tex/fonts/psvf ).
81: The file
82: .B testfont.tex
83: (in the standard macro directory) will print a table of any font.
84: .PP
85: These environment variables adjust the behavior of
86: .IR tex :
87: .TF TEXINPUTS
88: .TP
89: .B TEXINPUTS
90: Search path for
91: .B \einput
92: and
93: .B \eopenin
94: files.
95: It should be colon-separated,
96: and start with dot.
97: Default:
98: .B .:/sys/lib/tex/macros
99: .TP
100: .B TEXFONTS
101: Search path for font metric files.
102: Default:
103: .B /sys/lib/tex/fonts/tfm
104: .TP
105: .B TEXFORMATS
106: Search path for format files.
107: Default:
108: .B /sys/lib/tex/macros
109: .TP
110: .B TEXPOOL
111: Search path for strings.
112: Default:
113: .B /sys/lib/tex
114: .TP
115: .B TEXEDIT
116: Template for the switch-to-editor-on-error option,
117: with
118: .B %s
119: for the file name
120: and
121: .B %d
122: for the line number.
123: Default:
124: .B /bin/ed %s
125: .PD
126: .PP
127: .I Latex
128: is a version of
129: .I tex
130: with a standard set of macros loaded.
131: .I Latex
132: produces
133: .IB file .dvi
134: and a cross-referencing file,
135: .IB file .aux\f1.
136: It might be necessary to run
137: .I latex
138: twice, to get all of the cross-referencing done properly.
139: .I Slitex
140: is a variant of
141: .I latex
142: with fonts and commands suitable for making slides.
143: .PP
144: .I Bibtex
145: is a bibliography processing program, often used in conjunction
146: with
147: .IR latex .
148: .I Bibtex
149: reads the top-level auxiliary
150: .RB ( .aux )
151: file output by
152: .I latex
153: and creates a bibliography
154: .RB ( .bbl )
155: file to be included in the LaTeX
156: source file.
157: The
158: .I auxname
159: on the command line should be given without an extension.
160: Each
161: .B \ecite
162: in the source file is looked up in bibliography files to gather
163: together those used in the document.
164: Then a bibliography style file is executed to write a
165: .B \ethebibliography
166: environment.
167: .PP
168: The source file should have defined the bibliography
169: .RB ( .bib )
170: files to search with the
171: .B \ebibliography
172: command, and the bibliography style
173: .RB ( .bst )
174: file to execute with the
175: .B \ebibliographystyle
176: command.
177: .I Bibtex
178: searches the
179: .B TEXINPUTS
180: path for
181: .BR .bst
182: files, and the
183: .B BIBINPUTS
184: path for
185: .B .bst
186: files.
187: The LaTeX manual describes how to make bibliography files.
188: .PP
189: .I Dvips
190: converts
191: .B .dvi
192: files to PostScript,
193: writing the result on standard output.
194: It is normally invoked by
195: .IR lp (1),
196: but if invoked separately, the following options are useful:
197: .TP "\w'\fL-T\fP \fIdev\fLXX'u"
198: .B -r
199: reverse pages.
200: .B -r0
201: means don't reverse pages (if reversing is default).
202: .TP
203: .BI -T dev
204: output device:
205: .I dev
206: is one of
207: .B laserwriter
208: (default for
209: .IR dvips ),
210: .BR fax ,
211: .BR gnot ,
212: .B lino
213: (the computer center's high resolution PostScript service), or
214: .B ljfour
215: (600 dpi PostScript).
216: .TP
217: .B -L
218: print paper in landscape mode.
219: .TP
220: .B -Z
221: compress the fonts before sending them.
222: .TP
223: .B -Z0
224: don't compress the fonts before sending them.
225: .PP
226: The following environment variables affect
227: .IR dvips :
228: .TF TEXVFONTS
229: .TP
230: .B TEXPKS
231: Search path for font bitmaps (PK files).
232: .TP
233: .B TEXVFONTS
234: Search path for virtual font descriptions.
235: .PD
236: .PP
237: .I Dviselect
238: selects pages from a
239: .B .dvi
240: file, creating a new
241: .B .dvi
242: file.
243: A
244: .I range
245: is a string of the form
246: .I first:last
247: where both
248: .I first
249: and
250: .I last
251: are optional numeric strings, with negative numbers indicated by
252: a leading underscore character
253: .RB ( _ ).
254: If both
255: .I first
256: and
257: .I last
258: are omitted, the colon may also be omitted, or may be replaced
259: with an asterisk
260: .RB ( * ).
261: A
262: .I TeX page selector
263: is a list of pages separated by periods. A
264: .I "list of pages"
265: is described by a set of page TeX page selectors,
266: separated by commas and/or white space.
267: .I Dviselect
268: actually looks at the ten
269: .I count
270: variables that TeX writes; the first of these (\e\fLcount0\fP) is the
271: page number, with \e\fLcount1\fP through \e\fLcount9\fP having varied uses
272: depending on which macro packages are in use. (Typically \e\fLcount1\fP
273: is a chapter or section number.) A page is included in
274: .IR dviselect 's
275: output if all its \ecount values are within any one of the ranges
276: listed on the command line. For example, the command
277: .L "dviselect *.1,35:"
278: might select everything in chapter 1, as well as pages 35 and up.
279: .PP
280: Instead of \e\fLcount\fP values,
281: .I dviselect
282: can also select by absolute page number,
283: indicated by a leading equal sign
284: .RB ( = ).
285: Ranges of absolute
286: pages are also allowed:
287: .L "dviselect =3:7"
288: will extract the third
289: through seventh pages.
290: .PP
291: .I Dvips
292: understands some extended graphics commands that can be output using
293: .I "tpic specials"
294: in the TeX source.
295: Many of them work by building up a path of
296: .I x,y
297: pairs, and then doing something with the path.
298: The tpic coordinate system has its origin at the current dvi position
299: when a drawing special is emitted;
300: all length arguments are in units of milli-inches,
301: and the y-axis goes positive downward.
302: .TP
303: .BI "\especial{pa " "x y" }
304: Add
305: .I x,y
306: to the current path.
307: .TP
308: .B "\especial{fp}
309: Flush the current path: draw it as a polygonal line and reset the path
310: to be empty.
311: .TP
312: .BI "\especial{da " dlen }
313: Like
314: .B fp
315: but draw dashed line, with dashes
316: .I dlen
317: milli-inches long.
318: .TP
319: .BI "\especial{dt " slen }
320: Like
321: .B fp
322: but draw a dotted line, with dots
323: .I slen
324: apart.
325: .TP
326: .B "\especial{sp}"
327: Like
328: .B fp
329: but draw a quadratic spline. The spline goes through the midpoints of the
330: segments of the path, and straight pieces extend it to the endpoints.
331: .TP
332: .BI "\especial{ar " "x y xr yr s e" }
333: Draw a circular or elliptical arc with center at
334: .I x,y
335: and radii
336: .IR xr " and " yr .
337: The arc goes clockwise from angle
338: .I s
339: to angle
340: .I e
341: (angles measured clockwise from the positive x-axis).
342: .TP
343: .BI "\especial{pn " n }
344: Set line width (pen diameter) to
345: .IR n milli-inches.
346: .TP
347: .B "\especial{bk}"
348: Set shading to black (will fill the next object drawn with black).
349: .TP
350: .B "\especial{sh}"
351: Set shading to grey.
352: .TP
353: .B "\especial{wh}"
354: Set shading to white.
355: .TP
356: .BI "\especial{psfile=" "file options" }
357: Include
358: .IR file ,
359: which should be a PostScript illustration,
360: making its origin be the current dvi position.
361: The default PostScript transformation matrix will be in effect,
362: but it can be modified by the
363: .IR options ,
364: a list of space-separated
365: .IR key = value
366: assignments.
367: Allowed keys are:
368: hoffset, voffset, hscale, vscale, angle,
369: If supplied, these values are supplied to PostScript
370: .IR translate , scale ", and " rotate"
371: commands, in that order.
372: Also, keys hsize and vsize may be supplied, to cause clipping to
373: those sizes.
374: Sizes and offsets should be specified in points,
375: angles should be specified in degrees.
376: .PP
377: All of the specials leave TeX at the same position on the page that
378: it started in.
379: .PP
380: .I Mf
381: runs metafont, program that produces fonts for TeX.
382: It is used by
383: .I dvips
384: when bitmaps for a given font at a given size do not exist.
385: .SH FILES
386: .TF /sys/lib/tex/macros/doc/*
387: .TP
388: .B /sys/lib/tex/macros/*
389: macros and preloaded format files
390: .TP
391: .B /sys/lib/tex/macros/doc/*
392: more TeX-related documentation
393: .TP
394: .B /sys/lib/tex/fonts/tfm
395: font metrics
396: .TP
397: .B /sys/lib/tex/fonts/psvf
398: PostScript virtual font metrics
399: .TP
400: .B /sys/lib/tex/fonts/canonpk
401: bitmaps for Canon engines (300 dpi)
402: .TP
403: .B /sys/lib/tex/fonts/linopk
404: bitmaps for Linotron (1270 dpi)
405: .TP
406: .B /sys/lib/tex/fonts/ljfourpk
407: bitmaps for Laserjet 4 (600 dpi)
408: .TP
409: .B /sys/lib/tex/fonts/gnotpk
410: bitmaps for gnot screen (100 dpi)
411: .TP
412: .B /sys/lib/tex/*
413: miscellaneous configuration files and PostScript headers
414: .SH SOURCE
415: .B /sys/src/cmd/tex
416: .SH "SEE ALSO"
417: .IR pic (1),
418: .IR lp (1),
419: .IR proof (1),
420: .IR troff (1),
421: .I delatex
422: in
423: .IR deroff (1)
424: .br
425: D. E. Knuth,
426: .I The TEXbook,
427: Addison-Wesley, 1984
428: .br
429: L. Lamport,
430: .I
431: LaTeX, A Document Preparation System,
432: Addison-Wesley, 1985
433: .br
434: H. Trickey,
435: ``Latex User Guide'',
436: .I
437: Unix Research System Programmer's Manual,
438: Tenth Edition, Volume 2.
439: .br
440: Various documents in
441: .BR /sys/lib/tex/macros/doc .
442: .SH BUGS
443: Should be spelled τεχ.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.