--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/jdk/src/share/classes/com/sun/tools/example/doc/jdb.html Sat Dec 01 00:00:00 2007 +0000
@@ -0,0 +1,104 @@
+<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>