NAME

       TeXsis - TeX macros for Physicists

SYNOPSIS

       texsis [ filename ]

DESCRIPTION

       TeXsis  is a collection of TeX macros for typesetting physics documents such as papers and
       preprints, conference proceedings, books, theses, referee  reports,  letters,  and  memos.
       TeXsis macros provide automatic numbering of equations, automatic numbering and formatting
       of references, double column formatting, macros for making tables  and  figures,  with  or
       without  captions, including tables with horizontal and vertical rules.  TeXsis supports a
       wide variety of type sizes and a number of  specialized  document  formats,  and  it  even
       includes macros for making form letters for job applications or letters of recommendation.

       TeXsis is an extension of "plain" TeX, so anything you know how to do in plain TeX you can
       do in  TeXsis.   TeXsis  macro  instructions  are  simply  abbreviations  for  often  used
       combinations of control sequences used to typeset physics documents.  For more information
       about plain TeX see the man pages for tex(1), and/or The TeXbook, by D.E. Knuth.

       TeXsis is stored as a pre-loaded format so that it loads quickly (see the  man  pages  for
       initex(1),  and/or  "preloaded  formats"  in The TeXbook ).  To run TeXsis simply give the
       command texsis in place of the tex command, i.e.

         texsis [ filename ]

       where filename.tex is the name of a file containing TeX and/or TeXsis \controlsequences.

       TeXsis is initally in plain TeX mode, i.e. 10pt type and  singlespaced,  but  the  control
       sequence  \texsis  selects  12pt  type,  doublespacing, and enables other useful features.
       Alternatively, \paper turns on these features and sets  things  up  to  typeset  a  paper,
       \thesis  does the same for typesetting a thesis, \letter is used to produce a letter using
       macros similar to those listed in the back  of  The  TeXbook,  \memo  gives  a  setup  for
       producing memoranda, and so on.

       A manual which describes all of the TeXsis macro instructions is available.  It is written
       in TeXsis, so it serves as its own example of how to write a document  with  TeXsis.   The
       source code is also heavily commented, so it is possible to extract useful macros from the
       source code and modify them to suit your own purposes.   Provisions  are  made  for  local
       customization  of TeXsis.  In particular, the file TXSmods.tex, if it exists, is read from
       the current directory or from the path TEXINPUTS whenever  TeXsis  is  started.   You  can
       therefore  put  your  own  custom  macros for a given project in a directory and they will
       automatically be loaded when TeXsis is run from that directory.

INSTALLATION

       There is an appendix to the printed manual containing detailed installation  instructions,
       but  they  are  also  provided  in a form which can be processed by plain TeX, in the file
       Install.tex.

DIAGNOSTICS

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

FILES

       The  source files for TeXsis and the TeXsis manual are usually installed in the same place
       the rest of TeX is kept.  Although this may vary from intallation to installation, it will
       generally  include  a  root directory named texmf.  Common examples are /usr/share/texmf/,
       /usr/lib/teTeX/texmf, or /usr/local/lib/texmf.  Filenames here are relative to this  texmf
       root directory.

       web2c/texsis.fmt         TeXsis pre-loaded format.

       tex/texsis/TXS*.tex      TeXsis source code.

       tex/texsis/*.txs         "Style"  files  which  can  be  read  in  at run time for special
                                document formats.

       doc/texsis/TXS*.doc      Source for the printed TeXsis manual (written in TeXsis).

       tex/texsis/TXSsite.tex   Local site customization instructions (this is  read  only  once,
                                when the format file is created).

       tex/texsis/TXSpatch.tex  Run  time  patch  file  (like a system TeXsis.rc file, it is read
                                every time TeXsis is run).

       TXSmods.tex              Run time init file (this is read every time TeXsis  is  run  from
                                the current directory, or from the search path in TEXINPUTS ).

RESTRICTIONS

       Please  note  that  TeXsis  is  designed to be completely compatible with plain TeX.  As a
       result it cannot be compatible with LaTeX.

       Having the full manual written in TeXsis can cause a problem if you don't have  a  version
       of  TeXsis  already  running.  To get around this you can run Manual.tex through plain TeX
       and it will load the TeXsis files before processing the manual.  This  takes  longer,  but
       not by much.

BUGS

       Please      report      bugs      (or      suggestions      for      improvements)      to
       texsis@feynman.physics.lsa.umich.edu.

       Patchs to correct small problems or make small improvements are available at

               ftp://feynman.physics.lsa.umich.edu/texsis/

       in the file TXSpatch.tex (If that file doesn't exist then there are no current patches.)

SEE ALSO

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

AUTHORS

       Eric Myers <myers@umich.edu>
       Department of Physics
       University of Michigan
       Ann Arbor, Michigan  USA

       and

       Frank E. Paige <paige@bnl.gov>
       Physics Department
       Brookhaven National Laboratory
       Upton, New York 11973 USA

VERSION

       Revision Number: 2.18/beta3
       Release Date:  16 May 2000