Debugging with SableVM and Eclipse now possible!

[Grzegorz B. Prokopski]

The developers of the SableVM Project are proud to announce the
release of a Debug-enabled SableVM snapshot.  Thanks to the many
months of work by Nizar Ahmouda, SableVM now implements the JVMDI
and JDWP specifications and allows for debugging Java programs.

In short, it is now possible to debug Java applications and libraries
(including the basic class library) using SableVM and Eclipse!

        http://sablevm.org/screenshot/debug-full.png    

For more informations about SableVM and debugging in a 100% Free
Software environment we invite you to visit:

        http://sablevm.org
and
        http://sablevm.org/wiki/Debug
        

 Quick start instructions
==========================

The instructions below assume you have all the required libraries and
tools installed.  If not, you might need to consult the following
document:

        http://sablevm.org/svn/repository/sablevm/trunk/INSTALL


  Installation
-----------------

To get the whole thing working, open a terminal and do the following:

su
cd /tmp
wget -c
ftp://ftp.cse.buffalo.edu/pub/Eclipse/eclipse/downloads/drops/S-3.1M1-200408122000/eclipse-SDK-3.1M1-linux-gtk.zip
wget -c http://sablevm.org/people/nizar/sablevm-nizar-debug+3895.tar.gz
wget -c http://sablevm.org/people/nizar/sablevm-classpath-nizar-debug
+3895.tar.gz
wget -c http://sablevm.org/people/nizar/eclipse-sablevm
wget -c http://sablevm.org/download/release/1.11.3/sablevm-1.11.3.tar.gz
wget -c
http://sablevm.org/download/release/1.11.3/sablevm-classpath-1.11.3.tar.gz
for archive in sablevm-1.11.3.tar.gz sablevm-classpath-1.11.3.tar.gz \
  sablevm-nizar-debug+3895.tar.gz sablevm-classpath-nizar-debug
+3895.tar.gz; \
  do tar -zxf $archive; done
cd /tmp/sablevm-1.11.3 && ./configure && make install
cd /tmp/sablevm-classpath-1.11.3 && ./configure && make install
cd /tmp/sablevm-nizar-debug+3895 && ./configure && make install
cd /tmp/sablevm-classpath-nizar-debug+3895 && ./configure && make
install
cd /usr/local && unzip /tmp/eclipse-SDK-3.1M1-linux-gtk.zip
chmod +x /tmp/eclipse-sablevm && cp
-f /tmp/eclipse-sablevm /usr/local/bin
exit

Now you should be able to start Eclipse by typing 'eclipse-sablevm'
in a terminal window (you should not use root account for that).

  Eclipse setup
-----------------

To set up your Eclipse environment to use debug-enabled SableVM as its
JRE (Java Runtime Environment) do the following:

* If it is the first time you run Eclipse, accept the workspace
  location and choose 'Workbench' at startup.
* In the menu choose 'Window' -> 'Preferences'.
* Expand the 'Java' menu and choose 'Installed JREs'.
* Click 'Search...', go to /usr/local/sablevm-debug/, select
  lib/ directory and click 'OK'.
* Tick the box to select sablevm-debug as the default JRE and
  click 'OK'.
  
  You are now ready to take advantages of a user-friendly IDE to develop
  and debug your Java applications with SableVM.


 More informations, troubleshooting, reporting bugs, etc...
============================================================

For more informations about SableVM we invite you to visit our
web site at:

        http://sablevm.org

To obtain more informations on setup and troubleshooting
using debug-enabled SableVM with Eclipse see:
        
        http://sablevm.org/wiki/Debug

To query and report bugs use these addresses:

        http://sablevm.org/bugs
        http://sablevm.org/bugs/open
        http://sablevm.org/bugs/new

We appreciate your feedback.  Please let us know about your
experiences using our mailing lists:

        http://sablevm.org/lists/sablevm-user

The developers and users of SableVM are also often present on
#sablevm IRC channel in irc.freenode.net/irc.debian.org network.


=== CONCLUSION ===

We wish you great fun using SableVM.

Enjoy!


         The SableVM Project developers

-- 
Grzegorz B. Prokopski           <address@hidden>
SableVM - Free, LGPL'ed Java VM  http://sablevm.org
Why SableVM ?!?                  http://sablevm.org/wiki/Features
Debian GNU/Linux - the Free OS   http://www.debian.org