--- a/jdk/src/solaris/doc/sun/man/man1/jhat.1 Thu Apr 30 15:04:39 2009 -0700
+++ b/jdk/src/solaris/doc/sun/man/man1/jhat.1 Mon May 04 18:28:26 2009 -0700
@@ -1,4 +1,3 @@
-.'" t
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@@ -19,12 +18,12 @@
." 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 jhat 1 "05 Aug 2006"
-." Generated by html2roff
+."
+.TH jhat 1 "04 May 2009"
+." Generated from HTML by html2man (author: Eric Armstrong)
.LP
-.SH NAME
+.SH "Name"
jhat \- Java Heap Analysis Tool
.LP
.SH "SYNOPSIS"
@@ -45,16 +44,15 @@
.LP
.LP
+.RS 3
.TP 3
options
Options, if used, should follow immediately after the command name.
+.br
.TP 3
heap\-dump\-file
Java binary heap dump file to be browsed. For a dump file that contains multiple heap dumps, you may specify which dump in the file by appending "#<number> to the file name, i.e. "foo.hprof#3".
-.LP
-.SH "DESCRIPTION"
-.LP
-
+.SH "DESCRIPTION"
.LP
.LP
The \f3jhat\fP command parses a java heap dump file and launches a webserver. jhat enables you to browse heap dumps using your favorite webbrowser. jhat supports pre\-designed queries (such as 'show all instances of a known class "Foo"') as well as \f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) \- a SQL\-like query language to query heap dumps. Help on OQL is available from the OQL help page shown by jhat. With the default port, OQL help is available at http://localhost:7000/oqlhelp/
@@ -64,20 +62,20 @@
.LP
.RS 3
.TP 2
-*
-Use jmap \-dump option to obtain a heap dump at runtime;
+o
+Use jmap(1) \-dump option to obtain a heap dump at runtime;
.TP 2
-*
-Use jconsole option to obtain a heap dump via
+o
+Use jconsole(1) option to obtain a heap dump via
.na
\f2HotSpotDiagnosticMXBean\fP @
.fi
-http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticsMXBean.html at runtime;
+http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html at runtime;
.TP 2
-*
+o
Heap dump will be generated when OutOfMemoryError is thrown by specifying \-XX:+HeapDumpOnOutOfMemoryError VM option;
.TP 2
-*
+o
Use
.na
\f2hprof\fP @
@@ -89,10 +87,8 @@
.LP
\f3NOTE:\fP This tool is \f3experimental\fP and may \f3not\fP be available in future versions of the JDK.
.LP
-.SH "OPTIONS"
-.LP
-
-.LP
+.SH "OPTIONS"
+.RS 3
.TP 3
\-stack false/true
Turn off tracking object allocation call stack. Note that if allocation site information is not available in the heap dump, you have to set this flag to false. Default is true.
@@ -123,25 +119,23 @@
.TP 3
\-J<flag>\
Pass <flag> to the Java virtual machine on which jhat is run. For example, \-J\-Xmx512m to use a maximum heap size of 512MB.
+.RE
+
.LP
-.SH "SEE ALSO"
-.LP
+.SH "SEE ALSO"
.RS 3
.TP 2
-*
-jmap \- Java Memory Map
+o
+jmap(1)
.TP 2
-*
-jconsole \- Java Monitoring and Management Console
+o
+jconsole(1)
.TP 2
-*
+o
.na
\f2hprof \- Heap and CPU profiling tool\fP @
.fi
http://java.sun.com/developer/technicalArticles/Programming/HPROF.html
.RE
-
-.LP
-
-.LP
+.RE