| See README in parent directory before reading on. |
| |
| Okay, so now you know what this is all about. |
| |
| |
| |
| *** Introduction |
| |
| libgroovy is the core native Groovy library for runtime use. Any Groovy application |
| requires this library (and the standard libgcj libraries) to run. |
| |
| libgroovy only contains a subset of the standard Groovy library. Currently it only |
| runs basic Groovy scripts. |
| |
| You may notice that there are no actual source files here. This is because libgroovy |
| is built from the Java source files from Groovy. The source files for the Java ASM |
| library are also required. |
| |
| |
| |
| *** Building the library. |
| |
| This library currently only compiles on UNIX. |
| |
| You need: |
| - JDK. |
| - GCJ. |
| - The Java source for Groovy and ASM. |
| - Bash. |
| |
| Edit build.sh and set the appropriate variables at the top of the script. |
| |
| ./build.sh |
| (may take some time and generate a collection of warnings - but hopefully no errors). |
| |
| If all goes to plan, you should end up with libgroovy.so and libgroovy.jar in the current |
| directory. |
| |
| |
| |
| *** Notes on how the library is built. |
| |
| The stripped down library only tries to compile the classes listed in groovy-src and asm-src. |
| |
| Certain tweaks needed to be made to get the source to compile as GCJ only partially supports |
| the J2SE1.4 library. Rather than modify the Groovy source, build.sh patches the source using |
| patch.diff to get the code to compile (although nobbling some features in doing so). |
| |
| |
| |
| *** How to use the library. |
| |
| Coming soon. In the mean time, look at one of the examples. |
| |
| |
| |
| - Joe Walnes <joe@thoughtworks.net> |
| |
| |