botclient/botnetclient/lisp/lib/java/abcl/README

   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.9 fails 54 out of 21344 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 Since this is a very early public release, there might be build problems as
  82 well as runtime bugs.
  83
  84 Please report problems to the j-devel mailing list:
  85
  86     armedbear-j-devel@lists.sourceforge.net
  87
  88 Have fun!
  89
  90 Peter Graves
  91 October 18, 2005