Return to tex.1 CVS log

Up to [Research Unix] / researchv10dc / man / man1

Annotation of researchv10dc/man/man1/tex.1, revision 1.1

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.