                   Installing TeXsis on a Macintosh
                        using CMacTeX or OzTeX


This file describes a workable installation scheme (others are
possible) for TeXsis for each of the two major Macintosh shareware
versions of TeX, CMacTeX and OzTeX.

      These instructions do not apply to Mac OS X, where the TeX
      situation is currently in its early stages.  At present tetex is
      available, and there is a CMacTeX distribution for OS X based on
      the tetex tree.  Information about TeX tools for OS X can be
      found at:

	http://www.esm.psu.edu/mac-tex/versionsX.html


For both CMacTeX and OzTeX the working folder is assumed to be that
containing the current distribution of TeXsis.  It is assumed that the
TXSsite.tex file for the local site resides in the working folder,
prepared perhaps by editing TXSsite.000 or by copying or editing a
previously existing TXSsite.tex file.

You should probably read the file Install.ps, even though it does not
mention the Macintosh.  The principles are the same.


For CMacTeX 3.7:

  * Execute CMacTeX from the CMacTeX binaries folder.

  * In the "Build format" menu under "File", select "other..."
  
  * Type the following line into the "Execute" window that pops up:

      tex -ini -fmt=texis &tex texsis \dump
      
  * Click on the Set Directory button.  Navigate to the working
    directory and highlight it.  Click on the Choose button to
    choose it.

  * That brings you back to the "Execute" window. Click "OK".
  
  * This produces the file texsis.fmt in the working folder.
    Move it to the CMaCTeX texmf:cmactex:texformats folder.

  * If it doesn't exist, make a folder called "texsis" in the CMacTeX
    texmf:tex folder.  Move all .txs files to texmf:tex:texsis, and
    all files of the form TX*.tex as well.  It will be necessary to
    update the tex macro files path with the CMacTeX setup utility if
    the texsis folder is not already in the path.

  * Move the texsis.bst file to the CMacTeX texmf:bibtex:bst folder.

  * If it doesn't exist, make a folder called "texsis" in the CMacTeX
    doc folder.  Move all the remaining files into doc:texsis.


For OzTeX 4.0:

  * Execute OzTeX.  Select "TeX...", then "..." under the TeX menu.
    When the file requestor comes up, go to the working directory and
    select Cancel, to make the working directory the default.

  * Select INITEX under the TeX menu.  At the ** prompt, enter

      TeXsis \dump

  * You should get the usual initex messages followed by a file save
    requestor for texsis.fmt.  Save it in the OzTeX TeX:Formats
    folder.

  * If it doesn't exist in the OzTeX TeX:Inputs folder, make a folder
    called "TeXsis" there, and move all .txs files into it, as well
    as all files of the form TX*.tex.

  * Move the file texsis.bst to "Extras:BibTeX:BibTeX inputs".

  * If it doesn't exist in the OzTeX TeX:Docs folder, make a folder
    there called "TeXsis".  Move all the remaining files into it.

  * Add the following lines to the OzTeX Local file in the
    current_app = OzTeX section:

      format_files = $c TeXsis
      input_folders = $c :TeX:Inputs:TeXsis:


In either case, you should now be able to run TeX on Manual.tex, with
TeXsis selected as the format, to produce the TeXis manual.  This is
worth doing as a test of the installation.  A PDF version of the
result is also available.


$Revision: 18.3 $  :  $Date: 2001/05/18 16:12:43 $  :  $Author: myers $
 _  ____________________________
(_\(__
 _|__)  David N. Williams
__|___  University of Michigan
\ |:-)  Physics Department
 \|     Ann Arbor, MI 48109-1120

