Changeset 13171


Ignore:
Timestamp:
01/22/11 10:17:41 (11 years ago)
Author:
Mark Evenson
Message:

Merge: r13165-13166: Update README.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/0.24.x/abcl/README

    r12900 r13171  
    33
    44Armed Bear Common Lisp is an implementation of ANSI Common Lisp that
    5 runs in a Java virtual machine.  It compiles its code to Java byte
    6 code.
     5runs in a Java virtual machine.  It compiles Lisp code directly to
     6Java byte code.
    77
    88
     
    1111
    1212Armed Bear Common Lisp is distributed under the GNU General Public
    13 License with classpath exception (described below).
     13License with a classpath exception (see "Classpath Exception" below).
    1414
    1515A copy of GNU General Public License (GPL) is included in this
     
    2020conditions of the GNU General Public License cover the whole
    2121combination.
     22
     23** Classpath Exception
    2224
    2325As a special exception, the copyright holders of this software give
     
    3941After you have downloaded a binary release archive unpack it into its
    4042own directory. To run ABCL directly from this directory, make sure
    41 Java (version 1.5 or up) is in your shell's path. Then issue following
    42 command
     43Java (version 1.5 or up) is in your shell's path. Then issue the
     44following command:
    4345
    4446    cmd$ java -jar abcl.jar
     
    4648which should result in output like the following
    4749
    48     Armed Bear Common Lisp 0.19.1
    49     Java 1.6.0_14 Sun Microsystems Inc.
     50    Armed Bear Common Lisp 0.25.0
     51    Java 1.6.0_21 Sun Microsystems Inc.
    5052    Java HotSpot(TM) Client VM
    51     Low-level initialization completed in 0.9 seconds.
     53    Low-level initialization completed in 0.3 seconds.
    5254    Startup completed in 2.294 seconds.
    5355    Type ":help" for a list of available commands.
     
    6163preferred (and most tested way) is to being to use the Ant build tool:
    6264
    63 * Use the Ant build tool for Java environments. 
     65* Use the Ant build tool for Java environments.
    6466
    6567* Use the Netbeans 6.x IDE to open ABCL as a project.
     
    7274tested).  Just the JRE isn't enough, as you need the Java compiler
    7375('javac') to compile the Java source of the ABCL implementation.
     76
     77Note that when deploying ABCL having JDK isn't a requirement for the
     78installation site, just the equivalent JRE, as ABCL compiles directly
     79to byte code, avoiding the need for the 'javac' compiler in deployment
     80environments.
    7481
    7582
     
    8592Then simply executing
    8693
    87     unix$  ant
     94    unix$ ant
    8895
    8996or
    90     cmd$ ant.bat   
     97    dos> ant.bat
    9198
    9299from the directory containing this README file will create an
     
    115122don't want to know anything about Java.
    116123
    117 First, copy the file 'customizations.lisp.in' to customization.lisp',
     124First, copy the file 'customizations.lisp.in' to 'customization.lisp',
    118125in the directory containing this README file, editing to suit your
    119126situation, paying attention to the comments in the file.  The critical
     
    134141    unix$ ./build-from-lisp.sh sbcl
    135142
    136 After a successful build, you may use 'abcl.bat' on Windows or 'abcl'
    137 on Unix to start ABCL.  Note that this wrappers contain absolute
    138 paths, so you'll need to edit them if you move things around after the
    139 build.
     143After a successful build, you may use 'abcl' ('abcl.bat' on Windows)
     144to start ABCL.  Note that this wrappers contain absolute paths, so
     145you'll need to edit them if you move things around after the build.
    140146
    141147If you're developing on ABCL, you may want to use
     
    151157This invokes javac separately for each .java file, which avoids running
    152158into limitations on command line length (but is a lot slower).
    153  
     159
    154160** Building from another Lisp by hand
    155161
     
    158164
    159165    CL-USER> (build-abcl:build-abcl :clean t :full t)
    160    
     166
    161167will build ABCL.  If ASDF isn't present, simply LOAD the
    162168'customizations.lisp' and 'build-abcl.lisp' files to achieve the same
     
    169175A lot of (renewed) energy has been spent to make ABCL a compliant
    170176and practically useable Common Lisp implementation.  Because of this,
    171 ABCL 0.19.1 now fails only 29 out of 21702 tests in the ANSI CL test
    172 suite.  Next to that, the fail count of the Maxima test suite has been
    173 reduced to only 5 - rounding errors.
     177ABCL 0.25.0 now fails only 28 out of 21702 tests in the ANSI CL test
     178suite.  In addition, Maxima's test suite runs without failures now
     179and ABCL's CLOS complete, with the exception of the long form of
     180DEFINE-METHOD-COMBINATION - which is an ongoing effort.
    174181
    175 ABCL's CLOS does not handle on-the-fly redefinition of classes
    176 correctly. Quite a bit of energy has been spent in versions 0.16.0 and
    177 0.17.0 to improve CLOS performance. There is no support for the long
    178 form of DEFINE-METHOD-COMBINATION, and certain other required CLOS
    179 features are also missing. Enough CLOS is there to run
    180 ASDF2 and CL-PPCRE.
     182The MOP implementation is incomplete.
    181183
    182 There is no MOP worth mentioning.
    183 
    184 Patches to address any of the issues mentioned above will be gladly
    185 accepted.
     184Patches to address any of the issues mentioned above will
     185be gladly accepted.
    186186
    187187Please report problems to the development mailing list:
     
    193193On behalf of all ABCL development team and contributors,
    194194Erik Huelsmann
    195 March 20, 2010
     195January 20, 2011
Note: See TracChangeset for help on using the changeset viewer.