TeX/Mathematicas 1.31 for Mathematica version 2.0

TeX/Mathematica is a set of tools that provide facilities of
Mathematica Notebooks in a UNIX environment, under GNU Emacs.  They
permit interaction between a text and a Mathematica buffer and, if
desired, the use of TeX/LaTeX to annotate Mathematica-based
explorations and programs.  Inclusion of Mathematica-generated
graphics in TeX/LaTeX documents printed using PostScript is
supported.  The tools also support the automatic generation of
Mathematica packages from Mathematica documents.

With these tools one can interactively develop and refine teaching and
research documents. The interactive nature of the tools encourages
Mathematica-based exploration as a natural part of the writing
process.


Getting TeX/Mathematica
***********************

The TeX/Mathematica tools for Mathematica version 2.0 are available from
Internet host `chem.bu.edu' [128.197.30.18] by anonymous `ftp' in directory
`/pub/tex-mathematica-2.0'.  (The TeX/Mathematica tools for Mathematica
version 1.2 are available in directory `/pub/tex-mathematica-1.2'.)  The
author can be reached at Internet address `dan@chem.bu.edu'.

The `ftp' directory contains four files

   * `README', which duplicates the information
     in this node.

   * `CHANGES', which describes changes that have been made.

   * `tex-mma-j.ps.Z', the compressed PostScript brief
     documentation/LaTeX example.

   * `tex-mma.tar.Z', the TeX/Mathematica distribution kit (includes the
     first three files).

In addition to these files, the directory `/pub/matrix-mechanics'
contains the source of a paper written with TeX/Mathematica.  It
illustrates package generation from a TeX/Mathematica document
(*Note Packages::).  See the file `README' there for further
details.


* Menu:

* Documentation::		LaTeX description of TeX/Mathematica
* Tool kit::			Contains the TeX/Mathematica tools
* Install::			Step-by-step installation instructions



LaTeX description of TeX/Mathematica
====================================

The PostScript document `tex-mma-j.ps.Z' is derived from the LaTeX
description of TeX/Mathematica.  Transfer the document from the
`ftp' directory in binary (image) mode and then print it with

     zcat tex-mma-j.ps.Z | lpr

The source for this document is the LaTeX file `tex-mma-j.tex' and
the BibTeX file `tex-mma-j.bib'.  You can use `tex-mma-j.tex'
as a LaTeX example of a TeX/Mathematica document.



Installation procedure
======================

  1. Transfer `tex-mma.tar.Z' in binary (image) mode into an empty
     directory, and extract its contents, with (for example)

          zcat tex-mma.tar.Z | tar xvf -

  2. The file `tex-mma.ps.Z' is the compressed TeX formatted version
     of the Info on-line documentation of TeX/Mathematica, made using
     the `texinfo.tex' included in the distribution (see the beginning
     of `tex-mma.texinfo' for directions).  The formatted version can be
     printed with

          zcat tex-mma.ps.Z | lpr

     It contains complete details of the TeX/Mathematica tools.


  3. Edit the shell script `tex-mma-install', according to the instructions
     there.  Then execute it, with, for example,

          chmod +x tex-mma-install;
          tex-mma-install

     This will customize the TeX/Mathematica tools for your system and
     place them in the appropriate directories.  If you want to change
     things, just re-edit `tex-mma-install' and then re-execute it.


  4. Add the contents of `tex-mma.m' to your Mathematica
     initialization file `init.m' and add the contents of
     `tex-mma.emacs' to your Emacs system default file `default.el'
     or your own initialization file `.emacs'.


  5. The latest version (1.8) of psfig/TeX is included.  This works with
     compressed figures, but this option requires a patch to the Rokicki
     `dvips' processor.  If you want to use compressed figures but have
     not already applied the patch, copy `dospecial.patch' into your
     `dvips' directory, run

          patch < dospecial.patch

     and then recompile `dvips'.   You can print the documentation
     for psfig/TeX 1.8 with, for example,

          zcat psfig-doc.ps.Z | lpr


You should be ready to go: Execute `rehash', startup emacs, run `M-x
latex-mathematica', for example (*Note Startup::), and have fun.



Changes from previous versions
==============================

The Mathematica PostScript prologue is changed for Mathematica
version 2.0.  You can convert graphics files generated by `PSTeX' with
Mathematica version 1.2 to the new format with the shell script
`tex-mma-convert'.

The output marker has been changed in this version (1.31) of
TeX/Mathematica from a blank line to a `.'  line (*Note Regular cells::).  *Note Marker::, for how to convert documents prepared with
earlier versions to the new non-blank marker (recommended), or how to
change the default marker back to a blank line (*not* recommended).



Files in the distribution kit
=============================

The TeX/Mathematica tools consist of the following:

Documentation things:


   * `tex-mma.texinfo', Texinfo documentation of TeX/Mathematica

   * `tex-mma.ps.Z', compressed Texinfo document
     formatted with TeX into PostScript

   * `tex-mma.info', Info file
     (this file)
     for on-line Emacs documentation

   * `tex-mma-j.tex', LaTeX description/example of TeX/Mathematica

   * `tex-mma-j.bib', BibTeX file for `tex-mma-j.tex'

   * `tex-mma-j.ps.Z', compressed LaTeX documentation formatted in
     PostScript

   * `sin3x.ps', Mathematica-generated figure included in
     `tex-mma-j.tex'

   * `tex-mma-tex.tex', TeX example of TeX/Mathematica

   * `texinfo.tex', TeX macros used to format `tex-mma.texinfo'


GNU Emacs things:

   * `tex-mma.el', the `tex-mathematica' package

   * `math.el', David Jacobson's Mathematica mode package (*Note math::)

   * `unix-tex-mma.el', example implementation of cell-type `unix'


TeX/LaTeX things:

   * `mathematica10pt.tex', TeX 10 point TeX/Mathematica interface

   * `mathematica12pt.tex', TeX 12 point TeX/Mathematica interface

   * `mathematica.sty', LaTeX generic TeX/Mathematica interface

   * `mathematica.tex', macros for formatting TeX/Mathematica
     documents, used by the preceding files

   * `mathematicag.sty', `mathematicag.tex', `mma-tex-mma.tex'
     and `unix-tex-mma.tex' are alternatives to `mathematica.sty'
     and `mathematica.tex' for multiple-cell types.  *Note Macros::.



Shell scripts and Mathematica commands for processing graphics, and
shell script and template file for Mathematica package assembly:

   * `PSTeX.m', generates `psfig'-adapted graphics to a file, without
     PostScript prolog

   * `addBBox', shell script called by `PSTeX'

   * `PSTeXpro.m', generates `psfig'-adapted graphics to a file, with
     PostScript prolog

   * `addBBoxpro', shell script called by `PSTeXpro'

   * `addBBoxpro.awk', `awk' script called by `addBBoxpro'

   * `PSFile.m', generates full-page graphics to a file, with PostScript
     prolog

   * `tex-mma-assemble-package', shell script for Mathematica package
     assembly

   * `tex-mma-assemble-package.el.tmplt', Emacs Lisp template for
     `tex-mma-assemble-package'


This is from Cameron Smith (*Note addBBox::):

   * `mma.pro-2.0', Mathematica Version 2.0 PostScript prolog.  Note
     that a different prolog is needed for Mathematica Version 1.2.  This
     is available from the author (*Note Getting tex-math::).

These are from Trevor Darrell's `psfig/tex' distribution (*Note psfig::):


   * `psfig.tex', `psfig' for TeX.

   * `psfig.sty', a symbolic link to `psfig.tex', for LaTeX.

   * `psfig-doc.ps.Z', the compressed PostScript documentation of
     psfig/TeX 1.8.

   * `dospecial.patch', patch for Rokicki's `dvips' to allow for
     `zcat' arguments to plotfile specials.
