Eliminate spurious redefinition of derivabbrev in Ctensor, fix documentation of diagm...
[maxima/cygwin.git] / README.lisps
blob7d76543a47d56e7801171120d6ad04eeb863b339
1 Notes on Lisp implementations for Maxima:
3 Clisp, CMUCL, Scieneer Common Lisp (SCL), GCL (ANSI-enabled only)
4 and SBCL can compile and execute Maxima.
5 Allegro Common Lisp and OpenMCL might also work, but have not
6 been fully tested.
8 Ports to other ANSI Common Lisps should be straightforward
9 and are welcome; please post a message on the Maxima mailing list
10 if you are interested in working on a port.
12 For specific Maxima and Lisp version number combinations,
13 see the ports page at the Maxima wiki:
14 http://maxima.sourceforge.net/wiki/index.php?Maxima%20ports
16 When Maxima is recompiled, the Lisp implementation is selected by
17 an argument of the form `--enable-foolisp' for the configure script.
18 `./configure --help' shows a list of the Lisp types recognized by
19 configure (among other options). Always specify the Lisp type;
20 configure tries to autodetect the Lisp type if it is not specified,
21 but it has been reported that autodetection can fail.
23 --------------------------------------------------------------------
24 Comparison of execution times for the run_testsuite function
25 All times are in elapsed seconds
27 Maxima      System                  GCL     SBCL    CMUCL   Clisp
29 pre-5.9.3   P2 450 MHz, Linux        75      91              301
32 --------------------------------------------------------------------
33 Clisp <http://clisp.cons.org>, <http://clisp.sourceforge.net>
35         Clisp includes GNU readline support, so Maxima has
36 advanced command-line editing facilities when built with it.
38 Clisp is compiled to bytecodes, so Maxima running on Clisp is
39 substantially slower than on Lisps compiled to machine instructions.
40 Clisp computes floating-point operations in software,
41 so floating-point operations in Clisp are much slower than in Lisps
42 which make use of hardware instructions for floating-point operations.
43 On the other hand, Clisp makes use of the GMP library for arbitrary-
44 precision integer computations.
46 There are Clisp implementations for many platforms
47 including MS Windows and Unix-like systems.
49 --------------------------------------------------------------------
50 CMUCL <http://cmucl.cons.org>
52         CMUCL is a fast option for Maxima on platforms where it is
53 available. The rmaxima front-end provides advanced line-editing
54 facilities for Maxima when compiled with CMUCL. rlwrap is available
55 from <http://utopia.knoware.nl/~hlub/uck/rlwrap/> .
57 CMUCL versions: 18e and 19a and later are known to work.
59 There are CMUCL implementations only for Unix-like systems
60 (not MS Windows).
62 --------------------------------------------------------------------
63 Scieneer Common Lisp (SCL) <http://www.scieneer.com/scl/>
65         Scieneer Common Lisp (SCL) is a fast option for Maxima for a
66 range of Linux and Unix platforms.  The SCL 1.2.8 release and later
67 are supported.  SCL offers a lower case, case sensitive, version which
68 avoids the Maxima case inversion issues with symbol names.  Tested
69 front end options are: maxima emacs mode available in the
70 interfaces/emacs/ directory, the emacs imaxima mode available from
71 http://members3.jcom.home.ne.jp/imaxima/, and TeXmacs available from
72 http://www.texmacs.org/
74 --------------------------------------------------------------------
75 GCL <http://savannah.gnu.org/projects/gcl>
77         GCL versions starting with 2.4.3 can be built with readline
78 support, so Maxima has advanced command-line editing facilities
79 when built with it. GCL produces a fast Maxima exectuable.
81 Only the ANSI-enabled version of GCL works with Maxima, i.e.,
82 when GCL is built, it must be configured with the --enable-ansi flag,
83 i.e., execute ``./configure --enable-ansi'' in the build directory
84 before executing make.
86 Whether GCL is ANSI-enabled or not can be determined by 
87 inspecting the banner which is printed when GCL is executed;
88 if ANSI-enabled, the banner should say "ANSI".
89 Also, the special variable *FEATURES* should include the keyword :ANSI-CL.
91 There are GCL implementations for many platforms
92 including MS Windows and Unix-like systems.
94 --------------------------------------------------------------------
95 SBCL <http://sbcl.sourceforge.net>
97     SBCL is a fork of CMUCL which differs in some minor details,
98 but most notably, it is simpler to rebuild SBCL than CMUCL.
100 rmaxima is recommended for use with SBCL. See CMUCL above.
102 There are SBCL implementations only for Unix-like systems
103 (not MS Windows).
105 --------------------------------------------------------------------
106 Allegro Common Lisp:
108         Maxima should work with Allegro Common Lisp, but
109 only limited testing has been done with these Lisp
110 implementations. User feedback would be welcome.
112 --------------------------------------------------------------------
113 CCL <http://clozure.com>
115     CCL, formerly known as OpenMCL, is known to work with maxima on
116 all platforms where ccl runs including Linux, Mac OSX, and Windows.
117 There are appear to be some bugs in the 32-bit version of ccl,  but
118 the 64-bit version passes all tests.
120 --------------------------------------------------------------------
121 ECL <http://ecls.sourceforge.net>
122     
123     ECL is known to work with maxima and passes the testsuite.  ECL
124 runs on many platforms and OSes.