Annotation of researchv10dc/man/adm/man1/tex.1, revision 1.1.1.1

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: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.