| <HTML> |
| <HEAD> |
| <TITLE>Release notes for the jdb debugger</TITLE> |
| </HEAD> |
| <BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000FF" VLINK="#000077" ALINK="#FF0000"> |
| |
| <TABLE BORDER=0 WIDTH="100%" > |
| <TR> |
| |
| <TD> |
| <CENTER> |
| <H1>Release notes for the jdb debugger</H1></CENTER> |
| </TD> |
| </TR> |
| </TABLE> |
| <!-- Body text begins here --> |
| <P> |
| <A HREF="index.html">Home Page</A> |
| |
| <P> |
| As a demonstration of the |
| <A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/architecture.html"> |
| Java<sup><font size=-2>TM</font></sup> Platform Debugger Architecture</A> |
| we are providing source code for the <b>jdb</b> debugger, which was |
| re-written to use |
| <A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/architecture.html#jdi"> |
| JDI</A>. |
| |
| <P> |
| <H2><b>jdb</b> man pages</H2> |
| <BLOCKQUOTE> |
| <a href="http://java.sun.com/j2se/1.4/docs/tooldocs/win32/jdb.html"><font size="+1"><b>jdb</b> man pages for Windows</font></a> |
| <P> |
| <a href="http://java.sun.com/j2se/1.4/docs/tooldocs/solaris/jdb.html"><font size="+1"><b>jdb</b> man pages for Solaris</font></a> |
| </BLOCKQUOTE> |
| <P> |
| <H2>Invoking <b>jdb</b></H2> |
| The <b>jdb</b> sample can be started by executing: |
| <PRE> |
| java com.sun.tools.example.debug.tty.TTY <options>.. <class-name> |
| </PRE> |
| where <class-name> is the name you would normally |
| place on the <code>java</code> command line. The <code>-help</code> |
| option provides information on options. |
| </P> |
| <P> |
| Note: the path to the <A HREF="index.html#SETUP">JDI Library</A> and to |
| the compiled <b>jdb</b> class files must be on the class path |
| used to invoke com.sun.tools.example.debug.tty.TTY. |
| |
| <p> |
| For more information on invoking and connecting, refer to the |
| <A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/conninv.html"> |
| Connection and Invocation Details</A> section of the |
| <A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/"> |
| JPDA documentation</A>, |
| particularly the section on <b>jdb</b>. |
| <P> |
| |
| |
| <H2>Source for jdb</H2> |
| Full source code for <b>jdb</b> is included under the |
| <code>debug</code> directory of <code>examples.jar</code>. |
| Note: these directories also include the |
| source for <a href="javadt.html"><code>javadt</code></a>. |
| Source code for these example applications is included to provide concrete |
| examples for debugger developers. Example code may be used, modified |
| and redistributed by debugger developers providing they adhere to the |
| terms in the COPYRIGHT notice. |
| <P> |
| <b>jdb</b> uses the following packages (found under the |
| <code>debug</code> directory): |
| <DL> |
| <DT><code>tty</code> |
| <DD>Application code |
| <DT><code>expr</code> |
| <DD>Expression processing code |
| </DL> |
| |
| <P> |
| <H2>Building jdb</H2> |
| To completely rebuild the <b>jdb</b> classes from the |
| provided source files under the <code>debug</code> directory, |
| you need only to compile them. No special |
| options are required, aside from those which set your classpath to |
| include the <A HREF="index.html#SETUP">JDI Library</A>. |
| </P> |
| <P> |
| However, if you want to modify the expression parser in the file |
| <code>Expr.jj</code>, you will need the |
| <a href="http://www.metamata.com/javacc/"> |
| JavaCC parser generator</a>. |
| It is available free from |
| <a |
| href="http://www.webgain.com/products/metamata/java_doc.html">Metamata |
| (now part of WebGain)</a>. |
| <P> |
| <hr> |
| <address><a href="mailto:java-debugger@java.sun.com">java-debugger@java.sun.com</a></address> |
| </P> |
| <P> |
| </P> |
| </BODY> |
| </HTML> |