Files | Admin

Notes:

Release Name: ruby 1.8.6 p110 for solaris nv

Notes:
== Ruby 1.8.6 p110 with rubygem 0.9.4 released on Solaris nv96 ==

The Ruby 1.8.6 p110 for Solaris made some specification for Solaris, also adds new features and fixed some bugs.

Specificaion:

* Ruby 1.8.6 p110 is installed in /usr/ruby/1.8 by adding package SUNWruby18u 
* Gems repository is installed in /var/ruby/1.8/gem_home by adding package SUNWruby18r
* Add soft links for ruby executable programs in /usr/ruby/1.8/bin in /usr/bin.   For example: /usr/bin/ruby18 is a soft link of /usr/ruby/1.8/bin/ruby, and /usr/bin/ruby is a soft link of /usr/bin/ruby18 if 1.8 is the latest version on the system.

New features:

* Add dtrace support for ruby 1.8.6 p110 on Solaris x86, which includes following probes:
  > function__entry
  > function__return
  > raise
  > rescue
  > line
  > gc__begin
  > gc__end
  > object__create__start
  > object__create__done
  > object__free
  > ruby__probe
  The support for sparc will come soon.
* The ruby 1.8.6 p110 for Solaris x86 and sparc are optimized by sun studio building options.
* Ext readline 5.2 is built in ruby 1.8.6 p110
* Add man page for gem 
  
Bugs Fixed:

* The ruby 1.8.6 p110 for Solaris sparc is optimized by removing unnecessary win
dows flushing.
* Fix the rdoc files generated unpredictably problem 

== How to install ruby 1.8.6 p110 on Solaris nv and Open Solaris ==

1) Make sure if ruby 1.8.6 p110 for Solaris is ready on your machine
   # pkginfo | grep ruby
2) If you don't find any output, download SUNWruby18-p110-snv96-sparc.pkg.bz2 or SUNWruby18-p110-snv96-x86.pkg.bz2 according  to your machine.
   # bunzip2 SUNWruby18-p110-snv96-*.pkg.bz2
3) Add package 
   # bunzip2 SUNWruby18-p110-snv96-*.pkg.bz2
   # pkgadd -d  SUNWruby18-p110-snv96-*.pkg
   Choose the default option all for install both SUNWruby18r and SUNWruby18u packages

== How to build source code of ruby 1.8.6 p110 on Solaris nv and Open Solaris ==

If you want to build ruby 1.8.6 p110 instead of add package direcrtly, you can download ruby1.8.6-p110-snv-src.tar.bz2, and following the steps.
   # bunzip2 -dc ruby1.8.6-p110-snv-src.tar.bz2 | gtar xpf - --no-same-owner

1) Make sure your are in directory ruby1.8.6-p110-snv-src for all the following steps.
   # cd ruby1.8.6-p110-snv-src

2) The shell script makeruby.sh can help to build Ruby 1.8.6 p110 and RubyGem 0.9.4, you can run following command for help.
   # makeruby.sh -h

There are two options for building:
 --ruby-prefix=DIR :
 The default target ruby prefix dir is /usr/ruby/1.8, while the gem repository is /var/ruby/1.8/gem_home
 And you can specify your own target dir by "--ruby-prefix=/You/Own/Dir", but it must be an absolute  path, as relative path is not acceptable for ruby prefi
x.
 For example:
   # makeruby.sh --ruby-prefix=/export/home/ruby/build

 --sunstudio :
 gcc is the default building environment, as sunstudio is not installed by default on solaris nv. gcc located in /usr/sfw/bin by default, make sure the /usr/
sfw/bin is set in the environment of PATH
 But you can also use sunstudio as your building environment by "--sunstudio", if it's ready on your machine.
 For example:
   # makeruby.sh --sunstudio

3) Make clean by:
   # makeruby.sh clean

== Thanks ==
Thanks for trying ruby 1.8.6 p110 on Solaris nv or Open Solaris, we'll keep on updating the latest stable ruby version on Solaris nv.

-- Chris (Sun ISVe-OSS team)



Changes: ---- Oct.9.2008 ---- ruby1.8.6-p110-snv-src.tar.bz2 is updated for a bug in Makefile.in of ruby 1.8.6 source code, patch ruby_Makefile_in.patch and ruby-dtrace-1.8.6.patch is updated for it.