README file for maxima


This system MAXIMA is a common lisp implementation due to William F.
Schelter, and is based on the original implementation of Macsyma at
MIT.  It is available through the National Energy Software Center at
Argonne Ill.

The known shortfalls of being completely within the common lisp standard,
are several calls to errset.  This can be circumvented but not completely
eliminated.

On most common lisp systems, all necessary files are in the src directory.
Basically one loads the file sysdef.lsp, after having set the directory
paths in that file, and then does a (make :maxima :compile t).  Before
dumping it one does (make :maxima).  

For smaller machines (eg sun3/50), the above is inefficient since the 
whole object is getting loaded during the compile.  So here we build
a smaller system, saved_max_compile, and use it to compile the rest of
the files.  


TO BUILD THE CLISP VERSION:

Install CLISP. Put this tree into /usr/local/maxima (or make a symbolic
link), such that this file is /usr/local/maxima/README.

% cd src
% make

This will take a long while. When all went OK, do

% make install


TO BUILD THE KCL VERSION:

The makefiles in this distribution are suitable for building MAXIMA
in KCL (Kyoto Common Lisp), in a reasonably efficient manner.

Use the version AKCL for KCL.  AKCL is a version of kyoto common lisp
with a few changes merged in.  
It is available on rascal.ics.utexas.edu:/usr2/ftp/pub

Read and Edit bin/add-all-defs.   It will insert correct pathnames
in each makefile, and also insert the akcl/makedefs file, for
your particular machine version of akcl.

% cd maxima
% bin/add-all-defs

Now 

% make

To test the system

% make test


TO BUILD THE LISPM VERSION:

(TI Explorer or symbolics)

Edit the file src/cl-maxima.system to set the logical pathnames
Follow the instructions at the top of that file.  
The current version should work for TI release 3, and symbolics release 7


W. Schelter, the University of Texas, and other parties provide this
program on an "as is" basis without warranty of any kind, either
expressed or implied, including, but not limited to, the implied
warranties of merchantability and fitness for a particular purpose.

