Return to tex CVS log

Up to [Plan 9 NeXT] / lucent / sys / man / 1

Annotation of lucent/sys/man/1/tex, revision 1.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.