summaryrefslogtreecommitdiff
path: root/macros/mathematica/README
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/mathematica/README
Initial commit
Diffstat (limited to 'macros/mathematica/README')
-rw-r--r--macros/mathematica/README222
1 files changed, 222 insertions, 0 deletions
diff --git a/macros/mathematica/README b/macros/mathematica/README
new file mode 100644
index 0000000000..9b783e7ff6
--- /dev/null
+++ b/macros/mathematica/README
@@ -0,0 +1,222 @@
+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 are available from Internet host
+`chem.bu.edu' [128.197.30.18] by anonymous `ftp' in directory
+`/pub/tex-mathematica'. 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 documentation/example.
+
+ * `tex-mma.tar.Z', the TeX/Mathematica distribution kit (includes the
+ first three files).
+
+
+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.
+
+
+Files in the distribution kit
+=============================
+
+The file `tex-mma.tar.Z' contains the TeX/Mathematica
+tools. These 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
+
+
+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.tmplt', Emacs Lisp template used by
+ `tex-mma-assemble-package'
+
+
+This is from Cameron Smith (*Note addBBox::):
+
+ * `mma.pro.1.2', Mathematica Version 1.2 PostScript prolog. Note
+ that a different prolog will be needed for Mathematica Version 2.0.
+ This will be available from the author (*Note Getting tex-math::).
+
+These are from Trevor Darrell's `psfig/tex' distribution (*Note psfig::):
+
+ * `psfig.pro', `psfig' PostScript prolog.
+
+ * `psfig.sty', `psfig' for LaTeX.
+
+ * `psfig.tex', `psfig' for TeX.
+
+
+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. Install the Info on-line documentation file `tex-mma.info' where
+ your Emacs looks for Info file. If desired, add a pointer to it to your
+ Info directory file so that it will appear in the Info top-level menu.
+ The source for `tex-mma.info' is `tex-mma.texinfo'. The file
+ `tex-mma.ps.Z' is the compressed TeX formatted version, 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 `tex-mma.el' to
+
+ * set `tex-mma-process-string' to the command
+ you use to start Mathematica (default is `math');
+
+ * set `tex-mma-info-file' to point to where you put the file
+ `tex-mma.info'
+
+ 4. Run `M-x byte-compile' on `tex-mma.el' and store the resulting
+ `tex-mma.elc' wherever your GNU Emacs looks for files.
+
+ 5. Add the following to the GNU Emacs initialization file
+
+ (autoload 'tex-mathematica "tex-mma"
+ "Major-mode for interaction with Mathematica from TeX." t)
+ (autoload 'plain-tex-mathematica "tex-mma"
+ "Major-mode for interaction with Mathematica from TeX." t)
+ (autoload 'latex-mathematica "tex-mma"
+ "Major-mode for interaction with Mathematica from TeX." t)
+
+ 6. If you do not have David Jacobson's Mathematica mode package
+ `math.el', install it following the instructions in `math.el'.
+ If you do have `math.el', make sure your version is at least as
+ current as the one here, which contains changes necessary for use with
+ `tex-mma.el'. Make sure you place the file `math.el' (or,
+ better, the byte-compiled file `math.elc') where your Emacs looks
+ for libraries, so that `tex-mma.elc' will be able to load it if it
+ is not already loaded.
+
+ 7. Edit `mathematica.tex' (at the end) to specify where the PostScript
+ prolog files `psfig.pro' and `mma.pro.1.2' will be, and put the
+ prolog files there.
+
+ 8. If you are using a LaTeX *earlier* than 2 May 90, edit
+ `mathematica.sty' according to the comments there.
+
+ 9. Put `mathematica.tex', `mathematica.sty', `mathematica12pt.tex',
+ `mathematica10pt.tex', `psfig.sty', and `psfig.tex' where your
+ TeX looks for macro files.
+
+ 10. Put `PSTeX.m', `PSTeXpro.m' and `PSFile.m' where your
+ Mathematica looks for packages.
+
+ 11. Edit `addBBoxpro' to specify which `awk' you use (default is GNU
+ awk, `gawk').
+
+ 12. Edit `tex-mma-assemble-package' to set the variables `bindir', `tmpdir'
+ and `tmpdirsed' for your system, as described in the comments there
+ and then place `tex-mma-assemble-package.tmplt' in `bindir'.
+
+ 13. Put `addBBox', `addBBoxpro', `addBBoxpro.awk' and
+ `tex-mma-assemble-package' on your system's binary search path, make sure
+ they have execute status, and then execute `rehash'.
+
+
+You should be ready to go: Startup emacs, run `M-x tex-mathematica'
+and have fun.