How to install rb trepanning

R. Bernstein edited this page Jan 3, 2016 · 20 revisions

How to install rb-trepanning

Check out the Patches to Ruby 2.x and 1.9 to support beautiful debugging project to see if there is already a package made for your OS.

Install from RVM

Many people use rvm to allow multiple versions of Ruby and gems to coexist.

If you have rvm installed, download ruby-2.1.5-combined-rvm.patch from and then run:

 $ rvm install 2.1.5 -n 2.1.5-trepan --patch ./ruby-2.1.5-combined-rvm.patch

To match up the exact patchlevel with one of the combined patches you can specify the patch number in the rvm install. For example:

 $ rvm install 1.9.3-p392 -n 1.9.3-p392-trepan --patch ./patches/ruby-1.9.3-p392-combined-rvm.patch

After this is done you should be able to run gem install:

  $ gem install trepanning

If you are still on version 1.9 you need to specify an older version of trepanning. For example:

  $ gem install trepanning -v 1.93.35

Install from tarball

Look at the Ruby Debugger Runtime Project's Files section and download a tarball. Let's say you chose ruby-2.1.5-p273-debugger-1.2.tar.gz:

$ tar -xzpf ruby-2.1.5-p273-debugger-1.2.tar.gz
$ cd ruby-2.1.5-p273-debugger-1.2
$ ./configure && make
$ sudo make install-nodoc  # installs under ruby215d, gem215d...
$ gem215d install trepanning

For Ruby 1.9.3 you need to specify a version number in the 1.93 range. For example:

   $ tar -xzpf ruby-1.9.3-p551-debugger-1.2.tar.gz
$ cd ruby-1.9.3-p551-debugger-1.2
$ ./configure && make
$ sudo make install-nodoc  # installs under ruby193d, gem193d...
$ gem193d install trepanning --version 1.93.32
#                            ^^^^^^^^^^^^^^^^^

By default binaries have a suffix added so they don't conflict with the non-enhanced versions. Specifically, for Ruby 2.1.5 we add suffix 215d and for Ruby 1.9.3 we add suffix 193d to the following binaries:

  • gem (gem215d, gem193d)
  • ruby (ruby215d, ruby193d)
  • irb (irb215d, irb193d)
  • rake (rake215d, rake193d)
  • ri (ri215d, ri193d)

If you don't want the suffix, run configure with the --program-prefix=''. For example:

./configure --program-prefix=''

Note: on rvm no suffix is added or desired. rvm manages paths so there is no name conflict.

Try it!

$ trepan irb
-- (/usr/local/bin/irb:9)
require “irb” (trepan): # try: “help” or “quit” or EOF to leave
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.