Getting a working sandbox in eclipse

Getting a working sandbox is paramount if you want to contribute to JRuby development. This document will show you how it is done via Eclipse and from the command-line. It will also show some of the idiosynchracies in our project.

Part I: Eclipse

Eclipse is a popular platform for JRuby development. Most JRuby developers use it. Because of this, we have all the eclipse settings committed in our source tree. We can also provide assistance easier on our jruby-devel mailing list.

Step 1: Create a new project

At this point JRuby latest development source should be checked out into your new project.

You will notice many errors at this point. This is because eclipse 3.1 and earlier does not allow compiler settings to be stored in the projects local project settings. JRuby's source uses the Java's 'assert' facility and eclipses default settings are unhappy about this. To correct this, do the following:

At this point you should have a clean project that builds and with any luck has no warnings.

Part II: Command-line

TO BE WRITTEN STILL