Project:Ruby

Information for users
Right now, we include the following Ruby implementations in Gentoo.


 * ruby19 - Ruby MRI 1.9 (deprecated)
 * ruby20 - Ruby MRI 2.0
 * ruby21 - Ruby MRI 2.1
 * ruby22 - Ruby MRI 2.2

The following implementations need an active maintainer. They are currently available in the tree, but are unsupported. Ping us, if you want to help out!


 * jruby - JRuby (based on the Java Virtual Machine)
 * rbx - Rubinius

This graph shows the current distribution of Ruby implementations in Gentoo.

You can activate these by adding RUBY_TARGETS="$implementation" to your make.conf. Please note that you might overwrite the implementations set by base profile.

You can install multiple Ruby implementations in parallel. The RUBY_TARGETS picks the implementations from USE_RUBY (which is set in the ebuild) and installs these.

The base profile currently activates Ruby MRI 1.9 and Ruby 2.0. Our recommendation is to run Ruby packages with Ruby MRI 2.0 per default. You can eselect it via:

Information for developers
To ease maintenance of Ruby-based packages we currently provide several eclasses:


 * Support for generic ruby packages: ruby-ng.eclass
 * Support for gem-based ruby packages: ruby-fakegem.eclass
 * Support for packages in need of a ruby target: ruby-single.eclass

Further resources:


 * Packaging RubyGems
 * Ongoing Tasks
 * Pending Bumps
 * Adding new ruby versions
 * Ruby-Overlay
 * RubyGems packages that need an update
 * Ruby 1.9 deprecation

Old and probably outdated documents

 * Ruby 1.9 migration
 * Ruby 1.8 deprecation

