jruby-debug

jruby-debug copied to clipboard

= ruby-debug-base for JRuby

[NOTE: This project has been superceded by https://github.com/ruby-debug/ruby-debug. It is left for historical context (and was only valid for Netbeans IDE).

== Overview

(j)ruby-debug-base provides the fast debugger extension for JRuby interpreter. It is the same as ruby-debug-base native C extension from ruby-debug project (http://rubyforge.org/projects/ruby-debug/), but for JRuby.

== Install

(j)ruby-debug-base is available as a RubyGem:

jruby -S gem install ruby-debug-base

== Installation of trunk version

Handy for developers or users living on the cutting-edge.

$ cd ~/tmp $ svn co svn://rubyforge.org/var/svn/debug-commons/jruby-debug/trunk jruby-debug $ cd jruby-debug $ rake gem $ jruby -S gem install -l pkg/ruby-debug-base-0.10.3-java.gem $ jruby -S gem install columnize $ jruby -S gem install -r ruby-debug -v 0.10.3 --ignore-dependencies

== Usage

The usage is then the same as with native ruby-debugger, but you might need to force JRuby which has to run in interpreted mode. Simplest usage is:

$ jruby --debug -S rdebug

Or easier, you might create 'jruby-dm' ('dm' for 'debugger-mode'):

$ cat ~/bin/jruby-dm #!/bin/bash jruby --debug "$@"

Then you may run just as you used to:

$ jruby-dm -S rdebug

For more information see: http://bashdb.sourceforge.net/ruby-debug.html

== License

See MIT-LICENSE for license information.