--- a/jdk/src/linux/doc/man/jdb.1 Thu Apr 30 15:04:39 2009 -0700
+++ b/jdk/src/linux/doc/man/jdb.1 Mon May 04 18:28:26 2009 -0700
@@ -1,6 +1,4 @@
-.'" t
-."
-." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
+." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@@ -20,20 +18,21 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
-."
-." `
-.TH jdb 1 "05 Aug 2006"
-." Generated by html2roff
+."
+.TH jdb 1 "04 May 2009"
+." Generated from HTML by html2man (author: Eric Armstrong)
.LP
-.SH NAME
+.SH "Name"
jdb \- The Java Debugger
.LP
+.RS 3
.LP
.LP
\f3jdb\fP helps you find and fix bugs in Java language programs.
.LP
+.RE
.SH "SYNOPSIS"
.LP
@@ -49,6 +48,7 @@
.RS 3
.LP
+.RS 3
.TP 3
options
Command\-line options, as specified below.
@@ -58,6 +58,8 @@
.TP 3
arguments
Arguments passed to the \f2main()\fP method of \f2class\fP.
+.RE
+
.LP
.RE
.SH "DESCRIPTION"
@@ -74,6 +76,7 @@
.SS
Starting a jdb Session
.LP
+.RS 3
.LP
.LP
@@ -135,11 +138,11 @@
.na
\f2documentation\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html on these connection options. For information on starting a J2SE 1.4.2 or early VM for use with \f3jdb\fP see
+http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html on these connection options. For information on starting a J2SE 1.4.2 or early VM for use with \f3jdb\fP see the
.na
\f21.4.2 documentation\fP @
.fi
-http://java.sun.com/j2se/1.4.2/docs/technotes/guides/jpda/conninv.html
+http://java.sun.com/j2se/1.4.2/docs/guide/jpda/conninv.html
.LP
.SS
Basic jdb Commands
@@ -150,6 +153,7 @@
.RS 3
.LP
+.RS 3
.TP 3
help, or ?
The most important \f3jdb\fP command, \f2help\fP displays the list of recognized commands with a brief description.
@@ -163,24 +167,24 @@
print
Displays Java objects and primitive values. For variables or fields of primitive types, the actual value is printed. For objects, a short description is printed. See the \f2dump\fP command below for getting more information about an object.
.LP
-\f2NOTE: To display local variables, the containing class must have been compiled with the \fP\f2javac\fP\f2 \fP\f2\-g\fP option.
+\f2NOTE: To display local variables, the containing class must have been compiled with the \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP option.
.LP
\f2print\fP supports many simple Java expressions including those with method invocations, for example:
.RS 3
.TP 2
-*
+o
\f2print MyClass.myStaticField\fP
.TP 2
-*
+o
\f2print myObj.myInstanceField\fP
.TP 2
-*
+o
\f2print i + j + k\fP \f2(i, j, k are primities and either fields or local variables)\fP
.TP 2
-*
+o
\f2print myObj.myMethod()\fP \f2(if myMethod returns a non\-null)\fP
.TP 2
-*
+o
\f2print new java.lang.String("Hello").length()\fP
.RE
.TP 3
@@ -211,11 +215,14 @@
\f2where\fP with no arguments dumps the stack of the current thread. \f2where all\fP dumps the stack of all threads in the current thread group. \f2where\fP \f2threadindex\fP dumps the stack of the specified thread.
.LP
If the current thread is suspended (either through an event such as a breakpoint or through the \f2suspend\fP command), local variables and fields can be displayed with the \f2print\fP and \f2dump\fP commands. The \f2up\fP and \f2down\fP commands select which stack frame is current.
+.RE
+
.LP
.RE
.SS
Breakpoints
.LP
+.RS 3
.LP
.LP
@@ -223,16 +230,16 @@
.LP
.RS 3
.TP 2
-*
+o
\f2stop at MyClass:22\fP \f2(sets a breakpoint at the first instruction for line 22 of the source file containing MyClass)\fP
.TP 2
-*
+o
\f2stop in java.lang.String.length\fP \f2(sets a breakpoint at the beginnig of the method \fP\f2java.lang.String.length\fP)
.TP 2
-*
+o
\f2stop in MyClass.<init>\fP \f2(<init> identifies the MyClass constructor)\fP
.TP 2
-*
+o
\f2stop in MyClass.<clinit>\fP \f2(<clinit> identifies the static initialization code for MyClass)\fP
.RE
@@ -243,17 +250,21 @@
.LP
The \f2clear\fP command removes breakpoints using a syntax as in "\f2clear\ MyClass:45\fP". Using the \f2clear\fP or command with no argument displays a list of all breakpoints currently set. The \f2cont\fP command continues execution.
.LP
+.RE
.SS
Stepping
.LP
+.RS 3
.LP
.LP
The \f2step\fP commands advances execution to the next line whether it is in the current stack frame or a called method. The \f2next\fP command advances execution to the next line in the current stack frame.
.LP
+.RE
.SS
Exceptions
.LP
+.RS 3
.LP
.LP
@@ -268,6 +279,8 @@
.LP
\f2NOTE: The \fP\f2ignore\fP command does not cause the debugged VM to ignore specific exceptions, only the debugger.
.LP
+.RE
+.RE
.SH "Command Line Options"
.LP
@@ -278,6 +291,7 @@
.LP
The following additional options are accepted by \f3jdb\fP:
.LP
+.RS 3
.TP 3
\-help
Displays a help message.
@@ -300,8 +314,7 @@
\-listconnectors
List the connectors available in this VM
.TP 3
-\-connect
-<connector\-name>:<name1>=<value1>,...
+\-connect <connector\-name>:<name1>=<value1>,...
Connects to target VM using named connector with listed argument values.
.TP 3
\-dbgtrace [flags]
@@ -315,6 +328,8 @@
.TP 3
\-Joption
Pass \f2option\fP to the Java virtual machine used to run jdb. (Options for the application Java virtual machine are passed to the \f3run\fP command.) For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
+.RE
+
.LP
.LP
Other options are supported for alternate mechanisms for connecting the debugger and the VM it is to debug. The Java Platform Debugger Architecture has additional
@@ -326,6 +341,7 @@
.SS
Options Forwarded to Debuggee Process
.LP
+.RS 3
.TP 3
\-v \-verbose[:class|gc|jni]
Turns on verbose mode.
@@ -333,19 +349,20 @@
\-D<name>=<value>
Sets a system property.
.TP 3
-\-classpath <directories separated by
-":">
+\-classpath <directories separated by ":">
Lists directories in which to look for classes.
.TP 3
\-X<option>
Non\-standard target VM option
+.RE
+
.LP
.SH "SEE ALSO"
.LP
.LP
.LP
-javac, java, javah, javap, javadoc.
+javac(1), java(1), javah(1), javap(1), javadoc(1).
.LP
.LP