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.