1TEXSIS(1) User Manuals TEXSIS(1)
2
3
4
6 TeXsis - TeX macros for Physicists
7
8
10 texsis [ filename ]
11
12
14 TeXsis is a collection of TeX macros for typesetting physics documents
15 such as papers and preprints, conference proceedings, books, theses,
16 referee reports, letters, and memos. TeXsis macros provide automatic
17 numbering of equations, automatic numbering and formatting of refer‐
18 ences, double column formatting, macros for making tables and figures,
19 with or without captions, including tables with horizontal and vertical
20 rules. TeXsis supports a wide variety of type sizes and a number of
21 specialized document formats, and it even includes macros for making
22 form letters for job applications or letters of recommendation.
23
24 TeXsis is an extension of "plain" TeX, so anything you know how to do
25 in plain TeX you can do in TeXsis. TeXsis macro instructions are sim‐
26 ply abbreviations for often used combinations of control sequences used
27 to typeset physics documents. For more information about plain TeX see
28 the man pages for tex(1), and/or The TeXbook, by D.E. Knuth.
29
30 TeXsis is stored as a pre-loaded format so that it loads quickly (see
31 the man pages for initex(1), and/or "preloaded formats" in The TeXbook
32 ). To run TeXsis simply give the command texsis in place of the tex
33 command, i.e.
34
35 texsis [ filename ]
36
37 where filename.tex is the name of a file containing TeX and/or TeXsis
38 \controlsequences.
39
40 TeXsis is initally in plain TeX mode, i.e. 10pt type and singlespaced,
41 but the control sequence \texsis selects 12pt type, doublespacing, and
42 enables other useful features. Alternatively, \paper turns on these
43 features and sets things up to typeset a paper, \thesis does the same
44 for typesetting a thesis, \letter is used to produce a letter using
45 macros similar to those listed in the back of The TeXbook, \memo gives
46 a setup for producing memoranda, and so on.
47
48 A manual which describes all of the TeXsis macro instructions is avail‐
49 able. It is written in TeXsis, so it serves as its own example of how
50 to write a document with TeXsis. The source code is also heavily com‐
51 mented, so it is possible to extract useful macros from the source code
52 and modify them to suit your own purposes. Provisions are made for
53 local customization of TeXsis. In particular, the file TXSmods.tex, if
54 it exists, is read from the current directory or from the path TEXIN‐
55 PUTS whenever TeXsis is started. You can therefore put your own custom
56 macros for a given project in a directory and they will automatically
57 be loaded when TeXsis is run from that directory.
58
59
61 There is an appendix to the printed manual containing detailed instal‐
62 lation instructions, but they are also provided in a form which can be
63 processed by plain TeX, in the file Install.tex.
64
65
67 TeXsis informational messages are written to the terminal and the log
68 file begining with `% '. Warning and error messages begin with `> '.
69
70
72 The source files for TeXsis and the TeXsis manual are usually installed
73 in the same place the rest of TeX is kept. Although this may vary from
74 intallation to installation, it will generally include a root directory
75 named texmf. Common examples are /usr/share/texmf/,
76 /usr/lib/teTeX/texmf, or /usr/local/lib/texmf. Filenames here are rel‐
77 ative to this texmf root directory.
78
79 web2c/texsis.fmt TeXsis pre-loaded format.
80
81 tex/texsis/TXS*.tex TeXsis source code.
82
83 tex/texsis/*.txs "Style" files which can be read in at run time
84 for special document formats.
85
86 doc/texsis/TXS*.doc Source for the printed TeXsis manual (written
87 in TeXsis).
88
89 tex/texsis/TXSsite.tex Local site customization instructions (this is
90 read only once, when the format file is cre‐
91 ated).
92
93 tex/texsis/TXSpatch.tex Run time patch file (like a system TeXsis.rc
94 file, it is read every time TeXsis is run).
95
96 TXSmods.tex Run time init file (this is read every time
97 TeXsis is run from the current directory, or
98 from the search path in TEXINPUTS ).
99
100
102 Please note that TeXsis is designed to be completely compatible with
103 plain TeX. As a result it cannot be compatible with LaTeX.
104
105 Having the full manual written in TeXsis can cause a problem if you
106 don't have a version of TeXsis already running. To get around this you
107 can run Manual.tex through plain TeX and it will load the TeXsis files
108 before processing the manual. This takes longer, but not by much.
109
110
111
113 Please report bugs (or suggestions for improvements) to texsis@feyn‐
114 man.physics.lsa.umich.edu.
115
116 Patchs to correct small problems or make small improvements are avail‐
117 able at
118
119 ftp://feynman.physics.lsa.umich.edu/texsis/
120
121 in the file TXSpatch.tex (If that file doesn't exist then there are no
122 current patches.)
123
124
126 initex(1), tex(1), virtex(1)
127 Donald E. Knuth, The TeXbook;
128 Michael Doob, A Gentle Introduction to TeX.
129
130
132 Eric Myers <myers@umich.edu>
133 Department of Physics
134 University of Michigan
135 Ann Arbor, Michigan USA
136
137 and
138
139 Frank E. Paige <paige@bnl.gov>
140 Physics Department
141 Brookhaven National Laboratory
142 Upton, New York 11973 USA
143
144
146 Revision Number: 2.18/beta3
147 Release Date: 16 May 2000
148
149
150
151
152TeXsis 2.18 16 May 2000 TEXSIS(1)