summaryrefslogtreecommitdiff
path: root/static/unix-v10/man1/tex.1
diff options
context:
space:
mode:
Diffstat (limited to 'static/unix-v10/man1/tex.1')
-rw-r--r--static/unix-v10/man1/tex.1325
1 files changed, 325 insertions, 0 deletions
diff --git a/static/unix-v10/man1/tex.1 b/static/unix-v10/man1/tex.1
new file mode 100644
index 00000000..99c78cf7
--- /dev/null
+++ b/static/unix-v10/man1/tex.1
@@ -0,0 +1,325 @@
+.TH TEX 1
+.CT 1 writing_other
+.SH NAME
+tex, dvips, dvit, dvicat \- text formatting and typesetting
+.SH SYNOPSIS
+.B tex
+[
+.I first-line
+]
+.PP
+.B dvips
+[
+.I option ...
+]
+.I dvifile
+.PP
+.B dvit
+[
+.I option ...
+]
+.I dvifile
+.PP
+.B dvicat
+.I dvifile ...
+.SH DESCRIPTION
+.I Tex
+formats interspersed text and commands
+and outputs a
+.L .dvi
+(`device independent') file.
+.PP
+An argument given on the command line
+behaves as the first input line.
+That line should begin with a (possibly truncated) file name
+or a
+.LR \econtrolsequence .
+Thus
+.L tex paper
+processes the file
+.LR paper.tex .
+The basename of
+.L paper
+becomes the
+.IR jobname ,
+and is used in forming output file names.
+If no file is named, the jobname is
+.LR texput .
+The default
+.L .tex
+extension can be overridden by specifying an extension explicitly.
+.PP
+The output is written on
+.IB jobname .dvi ,
+which can be printed using
+.IR lp (1).
+A log of error messages goes into
+.IB jobname .log.
+.PP
+As well as the standard TeX fonts, many
+.I Postscript
+fonts can be used
+(see the contents of
+.FR /usr/lib/tex/fonts/psvf ).
+The file
+.F testfont.tex
+(in the standard macro directory) will print a table of any font.
+.PP
+These environment variables adjust the behavior of
+.IR tex :
+.TF TEXINPUTS
+.TP
+.B TEXINPUTS
+Search path for
+.L \einput
+and
+.L \eopenin
+files.
+It should be colon-separated,
+and start with dot.
+Default:
+.L .:/usr/lib/tex/macros
+.TP
+.B TEXFONTS
+Search path for font metric files.
+Default:
+.F /usr/lib/tex/fonts/tfm
+.TP
+.B TEXFORMATS
+Search path for format files.
+Default:
+.F /usr/lib/tex/macros
+.TP
+.B TEXPOOL
+Search path for strings.
+Default:
+.B /usr/lib/tex
+.TP
+.F TEXEDIT
+Template for the switch-to-editor-on-error option,
+with
+.L %s
+for the filename
+and
+.L %d
+for the line number.
+Default:
+.L /bin/ed %s
+.PD
+.PP
+.I Dvips
+and
+.I dvit
+convert
+.L .dvi
+files to Postscript
+and
+.I troff
+output format, respectively,
+writing the result on standard output.
+They are invoked by
+.IR lp (1)
+and accept a subset of
+.I lp
+options that make sense for
+.L .dvi
+files.
+In the
+.BI -o pagelist
+option for only printing selected pages,
+the numbers refer to TeX page numbers.
+In addition, there is a
+.BI -T dev
+option, where
+.I dev
+is one of
+.L laserwriter
+(default for
+.IR dvips ),
+.L jerq
+(default for
+.IR dvit ),
+.LR gnot ,
+.LR fax ,
+or
+.L lino
+(the computer center's high resolution Postscript service).
+The
+.L -Tjerq
+or
+.L -Tgnot
+options should be used for preparing output for
+.IR proof (9.1)
+or
+.IR psi (9.1).
+.PP
+When converting a number of short
+.L .dvi
+files to Postscript or using
+.I lp
+to print them, it is much more efficient first to combine them via
+.IR dvicat .
+Simply concatinating
+.L .dvi
+files would not work, but
+.I dvicat
+achieves this effect and sends the result to standard output.
+Since the output is in binary, it must be directed to a file or
+piped into
+.IR lp .
+.PP
+The following environment variables affect
+.IR dvips :
+.TF TEXVFONTS
+.TP
+.F TEXPKS
+Search path for font bitmaps (PK files).
+.TP
+.F TEXVFONTS
+Search path for `virtual font' descriptions.
+.PD
+.PP
+.I Dvips
+and
+.I dvit
+understand some extended graphics commands that can be output using
+.I "tpic specials"
+in the TeX source.
+Many of them work by building up a path of
+.I x,y
+pairs, and then doing something with the path.
+The tpic coordinate system has its origin at the current dvi position
+when a drawing special is emitted;
+all length arguments are in units of milli-inches,
+and the y-axis goes positive downward.
+.TP
+.BI "\especial{pa " "x y" }
+Add
+.I x,y
+to the current path.
+.TP
+.B "\especial{fp}
+Flush the current path: draw it as a polygonal line and reset the path
+to be empty.
+.TP
+.BI "\especial{da " dlen }
+Like
+.B fp
+but draw dashed line, with dashes
+.I dlen
+milli-inches long.
+.TP
+.BI "\especial{dt " slen }
+Like
+.B fp
+but draw a dotted line, with dots
+.I slen
+apart.
+.TP
+.B "\especial{sp}"
+Like
+.B fp
+but draw a quadratic spline. The spline goes through the midpoints of the
+segments of the path, and straight pieces extend it to the endpoints.
+.TP
+.BI "\especial{ar " "x y xr yr s e" }
+Draw a circular or elliptical arc with center at
+.I x,y
+and radii
+.IR xr " and " yr .
+The arc goes clockwise from angle
+.I s
+to angle
+.I e
+(angles measured clockwise from the positive x-axis).
+.TP
+.BI "\especial{pn " n }
+Set line width (pen diameter) to
+.IR n milli-inches.
+.TP
+.B "\especial{bk}"
+Set shading to black (will fill the next object drawn with black).
+.TP
+.B "\especial{sh}"
+Set shading to grey.
+.TP
+.B "\especial{wh}"
+Set shading to white.
+.TP
+.BI "\especial{psfile=" "file options" }
+(Only
+.IR dvips ).
+Include
+.IR file ,
+which should be a Postscript illustration,
+making its origin be the current dvi position.
+The default Postscript transformation matrix will be in effect,
+but it can be modified by the
+.IR options ,
+a list of
+.IR key = value
+assignments.
+Allowed keys are:
+hoffset, voffset, hscale, vscale, and rotate.
+If supplied, these values are supplied to Postscript
+.IR translate , scale ", and " rotate"
+commands, in that order.
+Also, keys hsize and vsize may be supplied, to cause clipping to
+those sizes.
+.TP
+.BI \especial{include " horg yorg file" }
+(Only
+.IR dvit ).
+Include the
+.IR troff (1)
+output
+.I file
+at the current place on TeX's page.
+The included file should have only one page.
+The
+.I horg
+and
+.I yorg
+distances give the origin of the included file;
+that point will be superimposed on the current position.
+.PP
+All of the specials leave TeX at the same position on the page that
+it started in.
+.SH FILES
+.TF /usr/lib/tex/macros/doc/*
+.TP
+.F /usr/lib/tex/macros/*
+macros and preloaded format files
+.TP
+.F /usr/lib/tex/macros/doc/*
+more TeX-related documentation
+.TP
+.F /usr/lib/tex/fonts/tfm
+font metrics
+.TP
+.F /usr/lib/tex/fonts/psvf
+PostScript virtual font metrics
+.TP
+.F /usr/lib/tex/fonts/canonpk
+bitmaps for canon engines (300 dpi)
+.TP
+.F /usr/lib/tex/fonts/linopk
+bitmaps for Linotron (1270 dpi)
+.TP
+.F /usr/lib/tex/*
+miscellaneous configuration files and Postscript headers
+.SH "SEE ALSO"
+.IR latex (6),
+.IR pic (1),
+.IR lp (1),
+.IR proof (9.1),
+.IR psi (9.1),
+.IR troff (1),
+.IR monk (1)
+.br
+Donald E. Knuth,
+.I The TEXbook,
+Addison Wesley, 1986
+.SH BUGS
+It should be possible to make TeX output go on standard output.
+