Fix for JRUBY-2469 - make sure that the meta-attribute always defines the method...
[jruby.git] / README
blob269b64aa05dab029b19c64b8c061f1a64cf3ec96
1 JRuby -  A Java implementation of the Ruby language
3 Authors: Stefan Matthias Aust, Anders Bengtsson, Geert Bevin,
4  Piergiuliano Bossi, Johannes Brodwall, Rocky Burt, Paul Butcher,
5  Benoit Cerrina, Wyss Clemens, David Corbin, Thomas E Enebo, Robert Feldt,
6  Russ Freeman, Chad Fowler, Joey Gibson, Kiel Hodges, Xandy Johnson,
7  Kelvin Liu, Alan Moore, Akinori Musha, Charles Nutter, Takashi Okamoto
8  Jan Arne Petersen, Tobias Reif, David Saff, Ed Sinjiashvili, Daiki Ueno
9  Matthias Veit, Jason Voegele, Sergey Yevtushenko, Robert Yokota, 
10  Ola Bini, Nick Sieger, and many gracious contributions from the community.
12 Project Contact: Thomas E Enebo <enebo@acm.org>
14 JRuby also uses code generously shared by the creator of the Ruby language, 
15 Yukihiro Matsumoto <matz@netlab.co.jp>.
17 == About
19 JRuby is the effort to recreate the Ruby (http://www.ruby-lang.org) interpreter
20 in Java.
22 The Java version is be tightly integrated with Java to allow both to script
23 any Java class and to embed the interpreter into any Java application. 
24 See the 'docs' directory for more information.
26 == Run
28     bin/jruby rubyfile.rb
30 interprets the file 'rubyfile.rb'.
32 == Compiling from source
34 You will need:
36 * JDK 1.4 or greater
37 * Apache Ant (http://jakarta.apache.org/ant/) 1.6.2 or greater.
39 To compile, just type:
41     ant
43 This will create a jruby.jar file in the projects 'lib' directory.
45 == Testing
47 In order to run the unit tests, copy the build_lib/junit.jar file to either
48 $ANT_HOME/lib/junit.jar or ~/.ant/lib/junit.jar.
50 See 'docs/README.test' for more information.
52 == More Information
54 Visit http://jruby.codehaus.org for more information.
56 == License
58 Read the COPYING file.