1 <HTML> |
|
2 <HEAD> |
|
3 <TITLE>Release notes for the jdb debugger</TITLE> |
|
4 </HEAD> |
|
5 <BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000FF" VLINK="#000077" ALINK="#FF0000"> |
|
6 |
|
7 <TABLE BORDER=0 WIDTH="100%" > |
|
8 <TR> |
|
9 |
|
10 <TD> |
|
11 <CENTER> |
|
12 <H1>Release notes for the jdb debugger</H1></CENTER> |
|
13 </TD> |
|
14 </TR> |
|
15 </TABLE> |
|
16 <!-- Body text begins here --> |
|
17 <P> |
|
18 <A HREF="index.html">Home Page</A> |
|
19 |
|
20 <P> |
|
21 As a demonstration of the |
|
22 <A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/architecture.html"> |
|
23 Java<sup><font size=-2>TM</font></sup> Platform Debugger Architecture</A> |
|
24 we are providing source code for the <b>jdb</b> debugger, which was |
|
25 re-written to use |
|
26 <A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/architecture.html#jdi"> |
|
27 JDI</A>. |
|
28 |
|
29 <P> |
|
30 <H2><b>jdb</b> man pages</H2> |
|
31 <BLOCKQUOTE> |
|
32 <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> |
|
33 <P> |
|
34 <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> |
|
35 </BLOCKQUOTE> |
|
36 <P> |
|
37 <H2>Invoking <b>jdb</b></H2> |
|
38 The <b>jdb</b> sample can be started by executing: |
|
39 <PRE> |
|
40 java com.sun.tools.example.debug.tty.TTY <options>.. <class-name> |
|
41 </PRE> |
|
42 where <class-name> is the name you would normally |
|
43 place on the <code>java</code> command line. The <code>-help</code> |
|
44 option provides information on options. |
|
45 </P> |
|
46 <P> |
|
47 Note: the path to the <A HREF="index.html#SETUP">JDI Library</A> and to |
|
48 the compiled <b>jdb</b> class files must be on the class path |
|
49 used to invoke com.sun.tools.example.debug.tty.TTY. |
|
50 |
|
51 <p> |
|
52 For more information on invoking and connecting, refer to the |
|
53 <A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/conninv.html"> |
|
54 Connection and Invocation Details</A> section of the |
|
55 <A HREF="http://java.sun.com/j2se/1.4/docs/guide/jpda/"> |
|
56 JPDA documentation</A>, |
|
57 particularly the section on <b>jdb</b>. |
|
58 <P> |
|
59 |
|
60 |
|
61 <H2>Source for jdb</H2> |
|
62 Full source code for <b>jdb</b> is included under the |
|
63 <code>debug</code> directory of <code>examples.jar</code>. |
|
64 Note: these directories also include the |
|
65 source for <a href="javadt.html"><code>javadt</code></a>. |
|
66 Source code for these example applications is included to provide concrete |
|
67 examples for debugger developers. Example code may be used, modified |
|
68 and redistributed by debugger developers providing they adhere to the |
|
69 terms in the COPYRIGHT notice. |
|
70 <P> |
|
71 <b>jdb</b> uses the following packages (found under the |
|
72 <code>debug</code> directory): |
|
73 <DL> |
|
74 <DT><code>tty</code> |
|
75 <DD>Application code |
|
76 <DT><code>expr</code> |
|
77 <DD>Expression processing code |
|
78 </DL> |
|
79 |
|
80 <P> |
|
81 <H2>Building jdb</H2> |
|
82 To completely rebuild the <b>jdb</b> classes from the |
|
83 provided source files under the <code>debug</code> directory, |
|
84 you need only to compile them. No special |
|
85 options are required, aside from those which set your classpath to |
|
86 include the <A HREF="index.html#SETUP">JDI Library</A>. |
|
87 </P> |
|
88 <P> |
|
89 However, if you want to modify the expression parser in the file |
|
90 <code>Expr.jj</code>, you will need the |
|
91 <a href="http://www.metamata.com/javacc/"> |
|
92 JavaCC parser generator</a>. |
|
93 It is available free from |
|
94 <a |
|
95 href="http://www.webgain.com/products/metamata/java_doc.html">Metamata |
|
96 (now part of WebGain)</a>. |
|
97 <P> |
|
98 <hr> |
|
99 <address><a href="mailto:java-debugger@java.sun.com">java-debugger@java.sun.com</a></address> |
|
100 </P> |
|
101 <P> |
|
102 </P> |
|
103 </BODY> |
|
104 </HTML> |
|