| 1 | GENERAL INFORMATION |
|---|
| 2 | ------------------- |
|---|
| 3 | |
|---|
| 4 | Armed Bear Common Lisp is an implementation of ANSI Common Lisp that runs in a |
|---|
| 5 | Java virtual machine. |
|---|
| 6 | |
|---|
| 7 | |
|---|
| 8 | LICENSE |
|---|
| 9 | ------- |
|---|
| 10 | |
|---|
| 11 | Armed Bear Common Lisp is distributed under the GNU General Public License |
|---|
| 12 | (with a special exception described below). |
|---|
| 13 | |
|---|
| 14 | A copy of GNU General Public License (GPL) is included in this distribution, in |
|---|
| 15 | the file COPYING. |
|---|
| 16 | |
|---|
| 17 | Linking this software statically or dynamically with other modules is making a |
|---|
| 18 | combined work based on this software. Thus, the terms and conditions of the GNU |
|---|
| 19 | General Public License cover the whole combination. |
|---|
| 20 | |
|---|
| 21 | As a special exception, the copyright holders of this software give you |
|---|
| 22 | permission to link this software with independent modules to produce an |
|---|
| 23 | executable, regardless of the license terms of these independent modules, and |
|---|
| 24 | to copy and distribute the resulting executable under terms of your choice, |
|---|
| 25 | provided that you also meet, for each linked independent module, the terms and |
|---|
| 26 | conditions of the license of that module. An independent module is a module |
|---|
| 27 | which is not derived from or based on this software. If you modify this |
|---|
| 28 | software, you may extend this exception to your version of the software, but |
|---|
| 29 | you are not obligated to do so. If you do not wish to do so, delete this |
|---|
| 30 | exception statement from your version. |
|---|
| 31 | |
|---|
| 32 | |
|---|
| 33 | INSTALLATION |
|---|
| 34 | ------------ |
|---|
| 35 | |
|---|
| 36 | To build ABCL, you'll need a 1.4 or 1.5 JDK and a supported Common Lisp |
|---|
| 37 | implementation (SBCL, CMUCL, OpenMCL, Allegro, LispWorks, or CLISP). |
|---|
| 38 | |
|---|
| 39 | Edit the file customizations.lisp, in the directory containing this README |
|---|
| 40 | file, to suit your situation, paying attention to the comments in the file. |
|---|
| 41 | |
|---|
| 42 | Start up one of the supported Common Lisp implementations in the directory |
|---|
| 43 | containing this README file. |
|---|
| 44 | |
|---|
| 45 | Load build-abcl.lisp: |
|---|
| 46 | |
|---|
| 47 | (load "build-abcl.lisp") |
|---|
| 48 | |
|---|
| 49 | Then do: |
|---|
| 50 | |
|---|
| 51 | (build-abcl:build-abcl :clean t :full t) |
|---|
| 52 | |
|---|
| 53 | Wait for the build to finish and exit the host Lisp. |
|---|
| 54 | |
|---|
| 55 | Use abcl.bat on Windows or ./abcl on Unix to start ABCL. (Note that abcl.bat |
|---|
| 56 | and abcl contain absolute paths, so you'll need to edit the relevant file if |
|---|
| 57 | you move things around after the build.) |
|---|
| 58 | |
|---|
| 59 | If the build fails in the javac stage, you might have better luck with this: |
|---|
| 60 | |
|---|
| 61 | (build-abcl:build-abcl :clean t :full t :batch nil) |
|---|
| 62 | |
|---|
| 63 | This invokes javac separately for each .java file, which is considerably slower |
|---|
| 64 | but avoids running into limitations on command line length. |
|---|
| 65 | |
|---|
| 66 | |
|---|
| 67 | BUGS |
|---|
| 68 | ---- |
|---|
| 69 | |
|---|
| 70 | ABCL is a very young implementation. You are certain to encounter bugs. |
|---|
| 71 | |
|---|
| 72 | ABCL 0.0.8 fails 93 out of 21320 tests in the GCL ANSI test suite. |
|---|
| 73 | |
|---|
| 74 | ABCL's CLOS does not handle on-the-fly redefinition of classes correctly, and |
|---|
| 75 | in any event is intolerably slow. There is no support for the long form of |
|---|
| 76 | DEFINE-METHOD-COMBINATION, and certain other required CLOS features are also |
|---|
| 77 | missing. Enough CLOS is there to run ASDF and CL-PPCRE, if you're in no hurry. |
|---|
| 78 | |
|---|
| 79 | There is no MOP worth mentioning. |
|---|
| 80 | |
|---|
| 81 | There is no support for logical pathnames. |
|---|
| 82 | |
|---|
| 83 | Since this is a very early public release, there might be build problems as |
|---|
| 84 | well as runtime bugs. |
|---|
| 85 | |
|---|
| 86 | Please report problems to the j-devel mailing list: |
|---|
| 87 | |
|---|
| 88 | armedbear-j-devel@lists.sourceforge.net |
|---|
| 89 | |
|---|
| 90 | Have fun! |
|---|
| 91 | |
|---|
| 92 | Peter Graves |
|---|
| 93 | August 30, 2005 |
|---|
