1TEXSIS(1)                        User Manuals                        TEXSIS(1)
2
3
4

NAME

6       TeXsis - TeX macros for Physicists
7
8

SYNOPSIS

10       texsis [ filename ]
11
12

DESCRIPTION

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

INSTALLATION

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

DIAGNOSTICS

67       TeXsis informational messages are written to the terminal and  the  log
68       file begining with `% '.  Warning and error messages begin with `> '.
69
70

FILES

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

RESTRICTIONS

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

BUGS

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

SEE ALSO

126       initex(1), tex(1), virtex(1)
127       Donald E. Knuth, The TeXbook;
128       Michael Doob, A Gentle Introduction to TeX.
129
130

AUTHORS

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

VERSION

146       Revision Number: 2.18/beta3
147       Release Date:  16 May 2000
148
149
150
151
152TeXsis 2.18                       16 May 2000                        TEXSIS(1)
Impressum