Merge

.hgtags

@@ -239,3 +239,4 @@ f26a0c8071bde1e3b923713c75156e4a58955623 jdk8-b114
 f82b730c798b6bf38946baaba8a7d80fd5efaa70 jdk8-b115
 0dc0067f3b8efb299a4c23f76ee26ea64df9e1d7 jdk8-b116
 fc4ac66aa657e09de5f8257c3174f240ed0cbaf7 jdk8-b117
+28ca338366ff2774ac9002f9f6eaff4101a3ea3b jdk8-b118

make/CompileDemos.gmk

 
 #
-# Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2011, 2013, Oracle and/or its affiliates. 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
@@ -56,25 +56,27 @@ define SetupAppletDemo
       BUILD_DEMOS += $$(BUILD_DEMO_APPLET_$1)
 endef
 
-$(eval $(call SetupAppletDemo,ArcTest))
-$(eval $(call SetupAppletDemo,BarChart))
-$(eval $(call SetupAppletDemo,Blink))
-$(eval $(call SetupAppletDemo,CardTest))
-$(eval $(call SetupAppletDemo,Clock))
-$(eval $(call SetupAppletDemo,DitherTest))
-$(eval $(call SetupAppletDemo,DrawTest))
-$(eval $(call SetupAppletDemo,Fractal))
-$(eval $(call SetupAppletDemo,GraphicsTest))
-$(eval $(call SetupAppletDemo,NervousText))
-$(eval $(call SetupAppletDemo,SimpleGraph))
-$(eval $(call SetupAppletDemo,SortDemo))
-$(eval $(call SetupAppletDemo,SpreadSheet))
-
-ifndef OPENJDK
-  $(eval $(call SetupAppletDemo,Animator,,closed/))
-  $(eval $(call SetupAppletDemo,GraphLayout,true,closed/))
-  $(eval $(call SetupAppletDemo,JumpingBox,,closed/))
-  $(eval $(call SetupAppletDemo,TicTacToe,,closed/))
+ifneq ($(OPENJDK_TARGET_OS), solaris)
+  $(eval $(call SetupAppletDemo,ArcTest))
+  $(eval $(call SetupAppletDemo,BarChart))
+  $(eval $(call SetupAppletDemo,Blink))
+  $(eval $(call SetupAppletDemo,CardTest))
+  $(eval $(call SetupAppletDemo,Clock))
+  $(eval $(call SetupAppletDemo,DitherTest))
+  $(eval $(call SetupAppletDemo,DrawTest))
+  $(eval $(call SetupAppletDemo,Fractal))
+  $(eval $(call SetupAppletDemo,GraphicsTest))
+  $(eval $(call SetupAppletDemo,NervousText))
+  $(eval $(call SetupAppletDemo,SimpleGraph))
+  $(eval $(call SetupAppletDemo,SortDemo))
+  $(eval $(call SetupAppletDemo,SpreadSheet))
+
+  ifndef OPENJDK
+    $(eval $(call SetupAppletDemo,Animator,,closed/))
+    $(eval $(call SetupAppletDemo,GraphLayout,true,closed/))
+    $(eval $(call SetupAppletDemo,JumpingBox,,closed/))
+    $(eval $(call SetupAppletDemo,TicTacToe,,closed/))
+  endif
 endif
 
 ##################################################################################################
@@ -157,14 +159,16 @@ $(JDK_OUTPUTDIR)/demo/jfc/CodePointIM/_the.services: \
 
 BUILD_DEMOS += $(JDK_OUTPUTDIR)/demo/jfc/CodePointIM/_the.services
 
-$(eval $(call SetupDemo,MoleculeViewer,applets,,XYZChemModel,,,example*.html *.java))
-$(eval $(call SetupDemo,WireFrame,applets,,ThreeD,,,example*.html *.java))
+ifneq ($(OPENJDK_TARGET_OS), solaris)
+  $(eval $(call SetupDemo,MoleculeViewer,applets,,XYZChemModel,,,example*.html *.java))
+  $(eval $(call SetupDemo,WireFrame,applets,,ThreeD,,,example*.html *.java))
+  $(eval $(call SetupDemo,SwingApplet,jfc,,SwingApplet,,,README* *.html))
+endif
 $(eval $(call SetupDemo,FileChooserDemo,jfc,,FileChooserDemo,,,README*))
 $(eval $(call SetupDemo,Font2DTest,jfc,,Font2DTest,,,*.html *.txt))
 $(eval $(call SetupDemo,Metalworks,jfc,,Metalworks,,,README*))
 $(eval $(call SetupDemo,Notepad,jfc,,Notepad,,,README*))
 $(eval $(call SetupDemo,SampleTree,jfc,,SampleTree,,,README*))
-$(eval $(call SetupDemo,SwingApplet,jfc,,SwingApplet,,,README* *.html))
 $(eval $(call SetupDemo,TableExample,jfc,,TableExample,,,README*))
 $(eval $(call SetupDemo,TransparentRuler,jfc,,transparentruler.Ruler,,,README*))
 $(eval $(call SetupDemo,jconsole-plugin,scripting,,,,,*.xml *.txt,,,,Main-Class: \n))
@@ -180,7 +184,7 @@ ifndef OPENJDK
 
   $(eval $(call SetupDemo,Java2D,jfc,,java2d.Java2Demo,,closed/,*.html README*,Java2Demo))
   $(eval $(call SetupDemo,Stylepad,jfc,,Stylepad, \
-      $(JDK_TOPDIR)/src/share/demo/jfc/Notepad,closed/,*.txt,,$(JDK_TOPDIR)/src/share/demo/jfc/Notepad/README.txt))
+  $(JDK_TOPDIR)/src/share/demo/jfc/Notepad,closed/,*.txt,,$(JDK_TOPDIR)/src/share/demo/jfc/Notepad/README.txt))
   $(eval $(call SetupDemo,SwingSet2,jfc,,SwingSet2,,closed/,README* *.html,,,.java COPYRIGHT, \
       SplashScreen-Image: resources/images/splash.png,true))
 
@@ -191,6 +195,9 @@ ifndef OPENJDK
   $(JDK_OUTPUTDIR)/demo/nbproject/%: $(JDK_TOPDIR)/src/closed/share/demo/nbproject/%
 	$(call install-file)
 	$(CHMOD) -f ug+w $@
+    ifeq ($(OPENJDK_TARGET_OS), solaris)
+	  $(RM) -r $(JDK_OUTPUTDIR)/demo/nbproject/jfc/SwingApplet
+    endif
 endif
 
 ##################################################################################################

src/bsd/doc/man/appletviewer.1

-." Copyright (c) 1995, 2012, Oracle and/or its affiliates. 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
-." under the terms of the GNU General Public License version 2 only, as
-." published by the Free Software Foundation.
-."
-." This code is distributed in the hope that it will be useful, but WITHOUT
-." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
-." version 2 for more details (a copy is included in the LICENSE file that
-." accompanied this code).
-."
-." You should have received a copy of the GNU General Public License version
-." 2 along with this work; if not, write to the Free Software Foundation,
-." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
-."
-." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
-." or visit www.oracle.com if you need additional information or have any
-." questions.
-."
-.TH appletviewer 1 "10 May 2011"
+'\" t
+.\"  Copyright (c) 1995, 2013, Oracle and/or its affiliates. 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
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"     Arch: generic
+.\"     Software: JDK 8
+.\"     Date: 21 November 2013
+.\"     SectDesc: Basic Tools
+.\"     Title: appletviewer.1
+.\"
+.if n .pl 99999
+.TH appletviewer 1 "21 November 2013" "JDK 8" "Basic Tools"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
 
-.LP
-.SH "Name"
-appletviewer \- The Java Applet Viewer.
-.LP
-.LP
-The \f3appletviewer\fP command allows you to run applets outside of a web browser.
-.LP
-.SH "SYNOPSIS"
-.LP
-.LP
-\f4appletviewer\fP \f2[\fP \f2options\fP \f2] \fP\f2urls\fP ...
-.LP
-.SH "DESCRIPTION"
-.LP
-.LP
-The \f3appletviewer\fP command connects to the documents or resources designated by \f2urls\fP and displays each applet referenced by the documents in its own window. Note: if the documents referred to by \f2urls\fP do not reference any applets with the \f2OBJECT\fP, \f2EMBED\fP, or \f2APPLET\fP tag, then \f3appletviewer\fP does nothing. For details on the HTML tags that \f3appletviewer\fP supports, see
-.na
-\f2AppletViewer Tags\fP @
-.fi
-http://download.oracle.com/javase/7/docs/technotes/tools/appletviewertags.html.
-.LP
-.LP
-\f3Note:\fP The \f3appletviewer\fP requires encoded URLs according to the escaping mechanism defined in RFC2396. Only encoded URLs are supported. However, file names must be unencoded, as specified in RFC2396.
-.LP
-.SH "OPTIONS"
-.LP
-.RS 3
-.TP 3
-\-debug
-Starts the applet viewer in the Java debugger, jdb(1), thus allowing you to debug the applets in the document.
-.TP 3
-\-encoding \  \ encoding name
-Specify the input HTML file encoding name.
-.TP 3
-\-Jjavaoption
-Passes through the string \f2javaoption\fP as a single argument to the Java interpreter which runs the appletviewer. The argument should not contain spaces. Multiple argument words must all begin with the prefix \f3\-J\fP, which is stripped. This is useful for adjusting the compiler's execution environment or memory usage.
-.RE
-
-.LP
-.LP
-
-.LP
+.SH NAME    
+appletviewer \- Runs applets outside of a web browser\&.
+.SH SYNOPSIS    
+.sp     
+.nf     
 
+\fBappletviewer\fR [\fIoptions\fR] \fIurl\fR\&.\&.\&.
+.fi     
+.sp     
+.TP     
+\fIoptions\fR
+The command-line options separated by spaces\&. See Options\&.
+.TP     
+\fIurl\fR
+The location of the documents or resources to be displayed\&. You can specify multiple URLs separated by spaces\&.
+.SH DESCRIPTION    
+The \f3appletviewer\fR command connects to the documents or resources designated by \fIurls\fR and displays each applet referenced by the documents in its own window\&. If the documents referred to by urls do not reference any applets with the \f3OBJECT\fR, \f3EMBED\fR, or \f3APPLET\fR tag, then the \f3appletviewer\fR command does nothing\&. For details about the HTML tags that the \f3appletviewer\fR command supports, see AppletViewer Tags at http://docs\&.oracle\&.com/javase/8/docs/technotes/tools/appletviewertags\&.html
+.PP
+The \f3appletviewer\fR command requires encoded URLs according to the escaping mechanism defined in RFC2396\&. Only encoded URLs are supported\&. However, file names must be unencoded, as specified in RFC2396\&.
+.PP
+\fINote:\fR The \f3appletviewer\fR command is intended for development purposes only\&. For more information, see About Sample/Test Applications and Code at http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/aboutCodeSamples\&.html
+.SH OPTIONS    
+.TP
+-debug
+.br
+Starts the Applet Viewer in the Java debugger with the \f3jdb\fR command to debug the applets in the document\&.
+.TP
+-encoding \fIencoding-name\fR
+.br
+Specifies the input HTML file encoding name\&.
+.TP
+-J\fIjavaoption\fR
+.br
+Passes the string \f3javaoption\fR as a single argument to the Java interpreter, which runs the Applet Viewer\&. The argument should not contain spaces\&. Multiple argument words must all begin with the prefix \f3-J\fR\&. This is useful for adjusting the compiler\&'s execution environment or memory usage\&.
+.PP
+.RE
+.br
+'pl 8.5i
+'bp

src/bsd/doc/man/extcheck.1

-." Copyright (c) 1998, 2012, Oracle and/or its affiliates. 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
-." under the terms of the GNU General Public License version 2 only, as
-." published by the Free Software Foundation.
-."
-." This code is distributed in the hope that it will be useful, but WITHOUT
-." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
-." version 2 for more details (a copy is included in the LICENSE file that
-." accompanied this code).
-."
-." You should have received a copy of the GNU General Public License version
-." 2 along with this work; if not, write to the Free Software Foundation,
-." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
-."
-." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
-." or visit www.oracle.com if you need additional information or have any
-." questions.
-."
-.TH extcheck 1 "10 May 2011"
+'\" t
+.\"  Copyright (c) 1998, 2013, Oracle and/or its affiliates. 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
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"     Arch: generic
+.\"     Software: JDK 8
+.\"     Date: 21 November 2013
+.\"     SectDesc: Basic Tools
+.\"     Title: extcheck.1
+.\"
+.if n .pl 99999
+.TH extcheck 1 "21 November 2013" "JDK 8" "Basic Tools"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
 
-.LP
-.SH "Name"
-extcheck \- A utility to detect jar conflicts
-.LP
-.LP
-\f3extcheck\fP detects version conflicts between a target jar file and currently installed extension jar files.
-.LP
-.SH "SYNOPSIS"
-.LP
-.nf
-\f3
-.fl
-extcheck [ \-verbose ] targetfile.jar
-.fl
-\fP
-.fi
+.SH NAME    
+extcheck \- Detects version conflicts between a target Java Archive (JAR) file and currently installed extension JAR files\&.
+.SH SYNOPSIS    
+.sp     
+.nf     
 
-.LP
-.SH "DESCRIPTION"
-.LP
-.LP
-The \f3extcheck\fP utility checks a specified Jar file for title and version conflicts with any extensions installed in the Java(TM) SDK. Before installing an extension, you can use this utility to see if the same or a more recent version of the extension is already installed.
-.LP
-.LP
-The \f3extcheck\fP utility compares the \f2Specification\-title\fP and \f2Specification\-version\fP headers in the manifest of the \f2targetfile.jar\fP file against the corresponding headers in all Jar files currently installed in the extension directory. (The extension directory is \f2jre/lib/ext\fP by default.) The \f3extcheck\fP utility compares version numbers in the same way as the method \f2java.lang.Package.isCompatibleWith\fP.
-.LP
-.LP
-If no conflict is detected, the return code is \f20\fP.
-.LP
-.LP
-If the manifest of any jar file in the extensions directory has the same \f2Specification\-title\fP and the same or a newer \f2Specification\-version\fP number, a non\-zero error code is returned. A non\-zero error code is also returned if \f2targetfile.jar\fP does not have the \f2Specification\-title\fP or \f2Specification\-version\fP attributes in its manifest.
-.LP
-.SH "OPTIONS"
-.LP
-.RS 3
-.TP 3
-\-verbose
-Lists Jar files in the extension directory as they are checked. Additionally, manifest attributes of the target jar file and any conflicting jar files are also reported.
-.TP 3
-\-Joption
-Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
-.RE
-
-.LP
-.SH "SEE ALSO"
-.LP
-.LP
+\fBextcheck\fR [\fIoptions\fR] \fItargetfile\&.jar\fR
+.fi     
+.sp     
+.TP     
+\fIoptions\fR
+The command-line options\&. See Options\&.
+.TP     
+\fItargetfile\&.jar\fR
+The target JAR file against which the currently installed extension JAR files are compared to detect version conflicts\&.
+.SH DESCRIPTION    
+The \f3extcheck\fR command checks a specified JAR file for title and version conflicts with any extensions installed in the Java SE SDK\&. Before installing an extension, you can use this utility to see whether the same or a more recent version of the extension is already installed\&.
+.PP
+The \f3extcheck\fR command compares the Specification-title and Specification-version headers in the manifest of the \f3targetfile\&.jar\fR file against the corresponding headers in all JAR files currently installed in the extension directory\&. By default, the extension directory is \f3jre/lib/ext\fR on Oracle Solaris and \f3\ejre\elib\eext\fR on Windows\&. The \f3extcheck\fR command compares version numbers in the same way as the \f3java\&.lang\&.Package\&.isCompatibleWith\fR method\&.
+.PP
+If no conflict is detected, then the return code is 0\&.
+.PP
+If the manifest of any JAR file in the extensions directory has the same \f3Specification-title\fR and the same or a newer \f3Specification-version\fR number, then a non-zero error code is returned\&. A non-zero error code is also returned when \f3targetfile\&.jar\fR does not have the \f3Specification-title\fR or \f3Specification-version\fR attributes in its manifest file\&.
+.SH OPTIONS    
+.TP
+-verbose
+.br
+Lists JAR files in the extension directory as they are checked\&. Additionally, manifest attributes of the target JAR file and any conflicting JAR files are also reported\&.
+.TP
+-J\fIoption\fR
+.br
+Passes \fIoption\fR to the Java Virtual Machine (JVM), where option is one of the options described on the reference page for the Java launcher\&. For example, \f3-J-Xms48m\fR sets the startup memory to 48 MB\&. See java(1)\&.
+.SH SEE\ ALSO    
+.TP 0.2i    
+\(bu
 jar(1)
-.LP
-
+.RE
+.br
+'pl 8.5i
+'bp

src/bsd/doc/man/javah.1

-." Copyright (c) 1994, 2012, Oracle and/or its affiliates. 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
-." under the terms of the GNU General Public License version 2 only, as
-." published by the Free Software Foundation.
-."
-." This code is distributed in the hope that it will be useful, but WITHOUT
-." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
-." version 2 for more details (a copy is included in the LICENSE file that
-." accompanied this code).
-."
-." You should have received a copy of the GNU General Public License version
-." 2 along with this work; if not, write to the Free Software Foundation,
-." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
-."
-." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
-." or visit www.oracle.com if you need additional information or have any
-." questions.
-."
-.TH javah 1 "10 May 2011"
+'\" t
+.\"  Copyright (c) 1994, 2013, Oracle and/or its affiliates. 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
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"     Arch: generic
+.\"     Software: JDK 8
+.\"     Date: 21 November 2013
+.\"     SectDesc: Basic Tools
+.\"     Title: javah.1
+.\"
+.if n .pl 99999
+.TH javah 1 "21 November 2013" "JDK 8" "Basic Tools"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
 
-.LP
-.SH "Name"
-javah \- C Header and Stub File Generator
-.LP
-.LP
-\f3javah\fP produces C header files and C source files from a Java class. These files provide the connective glue that allow your Java and C code to interact.
-.LP
-.SH "SYNOPSIS"
-.LP
-.nf
-\f3
-.fl
-javah [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
-.fl
-\fP
-.fi
+.SH NAME    
+javah \- Generates C header and source files from a Java class\&.
+.SH SYNOPSIS    
+.sp     
+.nf     
 
-.LP
-.SH "DESCRIPTION"
-.LP
-.LP
-\f3javah\fP generates C header and source files that are needed to implement native methods. The generated header and source files are used by C programs to reference an object's instance variables from native source code. The .h file contains a struct definition whose layout parallels the layout of the corresponding class. The fields in the struct correspond to instance variables in the class.
-.LP
-.LP
-The name of the header file and the structure declared within it are derived from the name of the class. If the class passed to \f3javah\fP is inside a package, the package name is prepended to both the header file name and the structure name. Underscores (_) are used as name delimiters.
-.LP
-.LP
-By default \f3javah\fP creates a header file for each class listed on the command line and puts the files in the current directory. Use the \f2\-stubs\fP option to create source files. Use the \f2\-o\fP option to concatenate the results for all listed classes into a single file.
-.LP
-.LP
-The new native method interface, Java Native Interface (JNI), does not require header information or stub files. \f3javah\fP can still be used to generate native method function proptotypes needed for JNI\-style native methods. \f3javah\fP produces JNI\-style output by default, and places the result in the .h file.
-.LP
-.SH "OPTIONS"
-.LP
-.RS 3
-.TP 3
-\-o outputfile
-Concatenates the resulting header or source files for all the classes listed on the command line into \f2outputfile\fP. Only one of \f3\-o\fP or \f3\-d\fP may be used.
-.TP 3
-\-d directory
-Sets the directory where \f3javah\fP saves the header files or the stub files. Only one of \f3\-d\fP or \f3\-o\fP may be used.
-.TP 3
-\-stubs
-Causes \f3javah\fP to generate C declarations from the Java object file.
-.TP 3
-\-verbose
-Indicates verbose output and causes \f3javah\fP to print a message to stdout concerning the status of the generated files.
-.TP 3
-\-help
-Print help message for \f3javah\fP usage.
-.TP 3
-\-version
-Print out \f3javah\fP version information.
-.TP 3
-\-jni
-Causes \f3javah\fP to create an output file containing JNI\-style native method function prototypes. This is the default output, so use of \f3\-jni\fP is optional.
-.TP 3
-\-classpath path
-Specifies the path \f3javah\fP uses to look up classes. Overrides the default or the CLASSPATH environment variable if it is set. Directories are separated by colons. Thus the general format for \f2path\fP is:
-.nf
-\f3
-.fl
-   .:<your_path>
-.fl
-\fP
-.fi
-For example:
-.nf
-\f3
-.fl
-   .:/home/avh/classes:/usr/local/java/classes
-.fl
-\fP
-.fi
-As a special convenience, a class path element containing a basename of \f2*\fP is considered equivalent to specifying a list of all the files in the directory with the extension \f2.jar\fP or \f2.JAR\fP (a java program cannot tell the difference between the two invocations).
+\fBjavah\fR [ \fIoptions\fR ] f\fIully\-qualified\-class\-name \&.\&.\&.\fR
+.fi     
+.sp     
+.TP     
+\fIoptions\fR
+The command-line options\&. See Options\&.
+.TP     
+\fIfully-qualified-class-name\fR
+The fully qualified location of the classes to be converted to C header and source files\&.
+.SH DESCRIPTION    
+The \f3javah\fR command generates C header and source files that are needed to implement native methods\&. The generated header and source files are used by C programs to reference an object\&'s instance variables from native source code\&. The \f3\&.h\fR file contains a \f3struct\fR definition with a layout that parallels the layout of the corresponding class\&. The fields in the \f3struct\fR correspond to instance variables in the class\&.
+.PP
+The name of the header file and the structure declared within it are derived from the name of the class\&. When the class passed to the \f3javah\fR command is inside a package, the package name is added to the beginning of both the header file name and the structure name\&. Underscores (_) are used as name delimiters\&.
+.PP
+By default the \f3javah\fR command creates a header file for each class listed on the command line and puts the files in the current directory\&. Use the \f3-stubs\fR option to create source files\&. Use the \f3-o\fR option to concatenate the results for all listed classes into a single file\&.
+.PP
+The Java Native Interface (JNI) does not require header information or stub files\&. The \f3javah\fR command can still be used to generate native method function prototypes needed for JNI-style native methods\&. The \f3javah\fR command produces JNI-style output by default and places the result in the \f3\&.h\fR file\&.
+.SH OPTIONS    
+.TP
+-o \fIoutputfile\fR
 .br
+Concatenates the resulting header or source files for all the classes listed on the command line into an output file\&. Only one of \f3-o\fR or \f3-d\fR can be used\&.
+.TP
+-d \fIdirectory\fR
 .br
-For example, if directory \f2foo\fP contains \f2a.jar\fP and \f2b.JAR\fP, then the class path element \f2foo/*\fP is expanded to a \f2A.jar:b.JAR\fP, except that the order of jar files is unspecified. All jar files in the specified directory, even hidden ones, are included in the list. A classpath entry consisting simply of \f2*\fP expands to a list of all the jar files in the current directory. The \f2CLASSPATH\fP environment variable, where defined, will be similarly expanded. Any classpath wildcard expansion occurs before the Java virtual machine is started \-\- no Java program will ever see unexpanded wildcards except by querying the environment. For example; by invoking \f2System.getenv("CLASSPATH")\fP.
-.TP 3
-\-bootclasspath path
-Specifies path from which to load bootstrap classes. By default, the bootstrap classes are the classes implementing the core Java 2 platform located in \f2jre/lib/rt.jar\fP and several other jar files.
-.TP 3
-\-old
-Specifies that old JDK1.0\-style header files should be generated.
-.TP 3
-\-force
-Specifies that output files should always be written.
-.TP 3
-\-Joption
-Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
-.RE
+Sets the directory where the \f3javah\fR command saves the header files or the stub files\&. Only one of \f3-d\fR or \f3-o\fR can be used\&.
+.TP
+-stubs
+.br
+Causes the \f3javah\fR command to generate C declarations from the Java object file\&.
+.TP
+-verbose
+.br
+Indicates verbose output and causes the \f3javah\fR command to print a message to \f3stdout\fR about the status of the generated files\&.
+.TP
+-help
+.br
+Prints a help message for \f3javah\fR usage\&.
+.TP
+-version
+.br
+Prints \f3javah\fR command release information\&.
+.TP
+-jni
+.br
+Causes the \f3javah\fR command to create an output file containing JNI-style native method function prototypes\&. This is the default output; use of \f3-jni\fR is optional\&.
+.TP
+-classpath \fIpath\fR
+.br
+Specifies the path the \f3javah\fR command uses to look up classes\&. Overrides the default or the \f3CLASSPATH\fR environment variable when it is set\&. Directories are separated by colons on Oracle Solaris and semicolons on Windows\&. The general format for path is:
+
+\fIOracle Solaris\fR:
+
+\&.:\fIyour-path\fR
 
-.LP
-.SH "ENVIRONMENT VARIABLES"
-.LP
-.RS 3
-.TP 3
-CLASSPATH
-Used to provide the system a path to user\-defined classes. Directories are separated by colons, for example,
-.nf
-\f3
-.fl
-.:/home/avh/classes:/usr/local/java/classes
-.fl
-\fP
-.fi
-.RE
+Example: \f3\&.:/home/avh/classes:/usr/local/java/classes\fR
 
-.LP
-.SH "SEE ALSO"
-.LP
-.LP
-javac(1), java(1), jdb(1), javap(1), javadoc(1)
-.LP
+\fIWindows\fR:
 
+\&.;\fIyour-path\fR
+
+Example: \f3\&.;C:\eusers\edac\eclasses;C:\etools\ejava\eclasses\fR
+
+As a special convenience, a class path element that contains a base name of * is considered equivalent to specifying a list of all the files in the directory with the extension \f3\&.jar\fR or \f3\&.JAR\fR\&.
+
+For example, if directory \f3mydir\fR contains \f3a\&.jar\fR and \f3b\&.JAR\fR, then the class path element \f3mydir/*\fR is expanded to a \f3A\fR\f3\&.jar:b\&.JAR\fR, except that the order of jar files is unspecified\&. All JAR files in the specified directory, including hidden ones, are included in the list\&. A class path entry that consists of * expands to a list of all the JAR files in the current directory\&. The \f3CLASSPATH\fR environment variable, where defined, is similarly expanded\&. Any class path wild card expansion occurs before the Java Virtual Machine (JVM) is started\&. A Java program will never see unexpanded wild cards except by querying the environment\&. For example, by calling \f3System\&.getenv("CLASSPATH")\fR\&.
+.TP
+-bootclasspath \fIpath\fR
+.br
+Specifies the path from which to load bootstrap classes\&. By default, the bootstrap classes are the classes that implement the core Java platform located in \f3jre\elib\ert\&.jar\fR and several other JAR files\&.
+.TP
+-old
+.br
+Specifies that old JDK 1\&.0-style header files should be generated\&.
+.TP
+-force
+.br
+Specifies that output files should always be written\&.
+.TP
+-J\fIoption\fR
+.br
+Passes \f3option\fR to the Java Virtual Machine, where \f3option\fR is one of the options described on the reference page for the Java application launcher\&. For example, \f3-J-Xms48m\fR sets the startup memory to 48 MB\&. See java(1)\&.
+.SH SEE\ ALSO    
+.TP 0.2i    
+\(bu
+javah(1)
+.TP 0.2i    
+\(bu
+java(1)
+.TP 0.2i    
+\(bu
+jdb(1)
+.TP 0.2i    
+\(bu
+javap(1)
+.TP 0.2i    
+\(bu
+javadoc(1)
+.RE
+.br
+'pl 8.5i
+'bp

src/bsd/doc/man/javap.1

-." Copyright (c) 1994, 2012, Oracle and/or its affiliates. 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
-." under the terms of the GNU General Public License version 2 only, as
-." published by the Free Software Foundation.
-."
-." This code is distributed in the hope that it will be useful, but WITHOUT
-." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
-." version 2 for more details (a copy is included in the LICENSE file that
-." accompanied this code).
-."
-." You should have received a copy of the GNU General Public License version
-." 2 along with this work; if not, write to the Free Software Foundation,
-." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
-."
-." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
-." or visit www.oracle.com if you need additional information or have any
-." questions.
-."
-.TH javap 1 "10 May 2011"
+'\" t
+.\"  Copyright (c) 1994, 2013, Oracle and/or its affiliates. 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
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"     Arch: generic
+.\"     Software: JDK 8
+.\"     Date: 21 November 2013
+.\"     SectDesc: Basic Tools
+.\"     Title: javap.1
+.\"
+.if n .pl 99999
+.TH javap 1 "21 November 2013" "JDK 8" "Basic Tools"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
 
-.LP
-.SH "Name"
-javap \- The Java Class File Disassembler
-.LP
-.LP
-Disassembles class files.
-.LP
-.SH "SYNOPSIS"
-.LP
-.nf
-\f3
-.fl
-javap [ \fP\f3options\fP\f3 ] classes
-.fl
-\fP
-.fi
+.SH NAME    
+javap \- Disassembles one or more class files\&.
+.SH SYNOPSIS    
+.sp     
+.nf     
 
-.LP
-.SH "DESCRIPTION"
-.LP
-.LP
-The \f3javap\fP command disassembles one or more class files. Its output depends on the options used. If no options are used, \f3javap\fP prints out the package, protected, and public fields and methods of the classes passed to it. \f3javap\fP prints its output to stdout.
-.LP
-.RS 3
-.TP 3
-options
-Command\-line options.
-.TP 3
-classes
-List of one or more classes (separated by spaces) to be processed for annotations (such as \f2DocFooter.class\fP). You may specify a class that can be found in the class path, by its file name (for example, \f2/home/user/myproject/src/DocFooter.class\fP), or with a URL (for example, \f2file:///home/user/myproject/src/DocFooter.class\fP).
-.RE
+\fBjavap\fR [\fIoptions\fR] \fIclassfile\fR\&.\&.\&.
+.fi     
+.sp     
+.TP     
+\fIoptions\fR
+The command-line options\&. See Options\&.
+.TP     
+\fIclassfile\fR
+One or more classes separated by spaces to be processed for annotations such as DocFooter\&.class\&. You can specify a class that can be found in the class path, by its file name or with a URL such as \f3file:///home/user/myproject/src/DocFooter\&.class\fR\&.
+.SH DESCRIPTION    
+The \f3javap\fR command disassembles one or more class files\&. The output depends on the options used\&. When no options are used, then the \f3javap\fR command prints the package, protected and public fields, and methods of the classes passed to it\&. The \f3javap\fR command prints its output to \f3stdout\fR\&.
+.SH OPTIONS    
+.TP
+-help, --help, -?
+.br
+Prints a help message for the \f3javap\fR command\&.
+.TP
+-version
+.br
+Prints release information\&.
+.TP
+-l
+.br
+Prints line and local variable tables\&.
+.TP
+-public
+.br
+Shows only public classes and members\&.
+.TP
+-protected
+.br
+Shows only protected and public classes and members\&.
+.TP
+-private, -p
+.br
+Shows all classes and members\&.
+.TP
+-J\fIoption\fR
+.br
+Passes the specified option to the JVM\&. For example:
+.sp     
+.nf     
+\f3javap \-J\-version\fP
+.fi     
+.nf     
+\f3javap \-J\-Djava\&.security\&.manager \-J\-Djava\&.security\&.policy=MyPolicy MyClassName\fP
+.fi     
+.nf     
+\f3\fP
+.fi     
+.sp     
 
-.LP
-.LP
-For example, compile the following class declaration:
-.LP
-.nf
-\f3
-.fl
-import java.awt.*;
-.fl
-import java.applet.*;
-.fl
-
-.fl
-public class DocFooter extends Applet {
-.fl
-        String date;
-.fl
-        String email;
-.fl
-
-.fl
-        public void init() {
-.fl
-                resize(500,100);
-.fl
-                date = getParameter("LAST_UPDATED");
-.fl
-                email = getParameter("EMAIL");
-.fl
-        }
-.fl
-
-.fl
-        public void paint(Graphics g) {
-.fl
-                g.drawString(date + " by ",100, 15);
-.fl
-                g.drawString(email,290,15);
-.fl
-        }
-.fl
-}
-.fl
-\fP
-.fi
-
-.LP
-.LP
-The output from \f3javap DocFooter.class\fP yields:
-.LP
-.nf
-\f3
-.fl
-Compiled from "DocFooter.java"
-.fl
-public class DocFooter extends java.applet.Applet {
-.fl
-  java.lang.String date;
-.fl
-  java.lang.String email;
-.fl
-  public DocFooter();
-.fl
-  public void init();
-.fl
-  public void paint(java.awt.Graphics);
-.fl
-}
-.fl
-\fP
-.fi
-
-.LP
-.LP
-The output from \f3javap \-c DocFooter.class\fP yields:
-.LP
-.nf
-\f3
-.fl
-Compiled from "DocFooter.java"
-.fl
-public class DocFooter extends java.applet.Applet {
-.fl
-  java.lang.String date;
-.fl
-
-.fl
-  java.lang.String email;
-.fl
-
-.fl
-  public DocFooter();
-.fl
-    Code:
-.fl
-       0: aload_0
-.fl
-       1: invokespecial #1                  // Method java/applet/Applet."<init>":()V
-.fl
-       4: return
-.fl
-
-.fl
-  public void init();
-.fl
-    Code:
-.fl
-       0: aload_0
-.fl
-       1: sipush        500
-.fl
-       4: bipush        100
-.fl
-       6: invokevirtual #2                  // Method resize:(II)V
-.fl
-       9: aload_0
-.fl
-      10: aload_0
-.fl
-      11: ldc           #3                  // String LAST_UPDATED
-.fl
-      13: invokevirtual #4                  // Method getParameter:(Ljava/lang/String;)Ljava/lang/String;
-.fl
-      16: putfield      #5                  // Field date:Ljava/lang/String;
-.fl
-      19: aload_0
-.fl
-      20: aload_0
-.fl
-      21: ldc           #6                  // String EMAIL
-.fl
-      23: invokevirtual #4                  // Method getParameter:(Ljava/lang/String;)Ljava/lang/String;
-.fl
-      26: putfield      #7                  // Field email:Ljava/lang/String;
-.fl
-      29: return
-.fl
-
-.fl
-  public void paint(java.awt.Graphics);
-.fl
-    Code:
-.fl
-       0: aload_1
-.fl
-       1: new           #8                  // class java/lang/StringBuilder
-.fl
-       4: dup
-.fl
-       5: invokespecial #9                  // Method java/lang/StringBuilder."<init>":()V
-.fl
-       8: aload_0
-.fl
-       9: getfield      #5                  // Field date:Ljava/lang/String;
-.fl
-      12: invokevirtual #10                 // Method java/lang/StringBuilder.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;
-.fl
-      15: ldc           #11                 // String  by
-.fl
-      17: invokevirtual #10                 // Method java/lang/StringBuilder.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;
-.fl
-      20: invokevirtual #12                 // Method java/lang/StringBuilder.toString:()Ljava/lang/String;
-.fl
-      23: bipush        100
-.fl
-      25: bipush        15
-.fl
-      27: invokevirtual #13                 // Method java/awt/Graphics.drawString:(Ljava/lang/String;II)V
-.fl
-      30: aload_1
-.fl
-      31: aload_0
-.fl
-      32: getfield      #7                  // Field email:Ljava/lang/String;
-.fl
-      35: sipush        290
-.fl
-      38: bipush        15
-.fl
-      40: invokevirtual #13                 // Method java/awt/Graphics.drawString:(Ljava/lang/String;II)V
-.fl
-      43: return
-.fl
-}
-.fl
-\fP
-.fi
-
-.LP
-.SH "OPTIONS"
-.LP
-.RS 3
-.TP 3
-\-help \-\-help \-?
-Prints out help message for \f3javap\fP.
-.TP 3
-\-version
-Prints out version information.
-.TP 3
-\-l
-Prints out line and local variable tables.
-.TP 3
-\-public
-Shows only public classes and members.
-.TP 3
-\-protected
-Shows only protected and public classes and members.
-.TP 3
-\-package
-Shows only package, protected, and public classes and members. This is the default.
-.TP 3
-\-private \-p
-Shows all classes and members.
-.TP 3
-\-Jflag
-Pass \f2flag\fP directly to the runtime system. Some examples:
-.nf
-\f3
-.fl
-javap \-J\-version
-.fl
-javap \-J\-Djava.security.manager \-J\-Djava.security.policy=MyPolicy MyClassName
-.fl
-\fP
-.fi
-.TP 3
-\-s
-Prints internal type signatures.
-.TP 3
-\-sysinfo
-Shows system information (path, size, date, MD5 hash) of the class being processed.
-.TP 3
-\-constants
-Shows static final constants.
-.TP 3
-\-c
-Prints out disassembled code, i.e., the instructions that comprise the Java bytecodes, for each of the methods in the class. These are documented in the
-.na
-\f2Java Virtual Machine Specification\fP @
-.fi
-http://java.sun.com/docs/books/vmspec/.
-.TP 3
-\-verbose
-Prints stack size, number of \f2locals\fP and \f2args\fP for methods.
-.TP 3
-\-classpath path
-Specifies the path \f3javap\fP uses to look up classes. Overrides the default or the CLASSPATH environment variable if it is set.
-.TP 3
-\-bootclasspath path
-Specifies path from which to load bootstrap classes. By default, the bootstrap classes are the classes implementing the core Java platform located in \f2jre/lib/rt.jar\fP and several other jar files.
-.TP 3
-\-extdirs dirs
-Overrides location at which installed extensions are searched for. The default location for extensions is the value of \f2java.ext.dirs\fP.
-.RE
-
-.LP
-.SH "SEE ALSO"
-.LP
-.LP
-javac(1), java(1), jdb(1), javah(1), javadoc(1)
-.LP
 
+For more information about JVM options, see the \f3java(1)\fR command documentation\&.
+.TP
+-s
+.br
+Prints internal type signatures\&.
+.TP
+-sysinfo
+.br
+Shows system information (path, size, date, MD5 hash) of the class being processed\&.
+.TP
+-constants
+.br
+Shows \f3static final\fR constants\&.
+.TP
+-c
+.br
+Prints disassembled code, for example, the instructions that comprise the Java bytecodes, for each of the methods in the class\&.
+.TP
+-verbose
+.br
+Prints stack size, number of locals and arguments for methods\&.
+.TP
+-classpath \fIpath\fR
+.br
+Specifies the path the \f3javap\fR command uses to look up classes\&. Overrides the default or the \f3CLASSPATH\fR environment variable when it is set\&.
+.TP
+-bootclasspath \fIpath\fR
+.br
+Specifies the path from which to load bootstrap classes\&. By default, the bootstrap classes are the classes that implement the core Java platform located in \f3jre/lib/rt\&.jar\fR and several other JAR files\&.
+.TP
+-extdir \fIdirs\fR
+.br
+Overrides the location at which installed extensions are searched for\&. The default location for extensions is the value of \f3java\&.ext\&.dirs\fR\&.
+.SH EXAMPLE    
+Compile the following \f3DocFooter\fR class:
+.sp     
+.nf     
+\f3import java\&.awt\&.*;\fP
+.fi     
+.nf     
+\f3import java\&.applet\&.*;\fP
+.fi     
+.nf     
+\f3\fP
+.fi     
+.nf     
+\f3public class DocFooter extends Applet {\fP
+.fi     
+.nf     
+\f3        String date;\fP
+.fi     
+.nf     
+\f3        String email;\fP
+.fi     
+.nf     
+\f3\fP
+.fi     
+.nf     
+\f3        public void init() {\fP
+.fi     
+.nf     
+\f3                resize(500,100);\fP
+.fi     
+.nf     
+\f3                date = getParameter("LAST_UPDATED");\fP
+.fi     
+.nf     
+\f3                email = getParameter("EMAIL");\fP
+.fi     
+.nf     
+\f3        }\fP
+.fi     
+.nf     
+\f3\fP
+.fi     
+.nf     
+\f3        public void paint(Graphics g) {\fP
+.fi     
+.nf     
+\f3                g\&.drawString(date + " by ",100, 15);\fP
+.fi     
+.nf     
+\f3                g\&.drawString(email,290,15);\fP
+.fi     
+.nf     
+\f3        }\fP
+.fi     
+.nf     
+\f3}\fP
+.fi     
+.nf     
+\f3\fP
+.fi     
+.sp     
+The output from the \f3javap DocFooter\&.class\fR command yields the following:
+.sp     
+.nf     
+\f3Compiled from "DocFooter\&.java"\fP
+.fi     
+.nf     
+\f3public class DocFooter extends java\&.applet\&.Applet {\fP
+.fi     
+.nf     
+\f3  java\&.lang\&.String date;\fP
+.fi     
+.nf     
+\f3  java\&.lang\&.String email;\fP
+.fi     
+.nf     
+\f3  public DocFooter();\fP
+.fi     
+.nf     
+\f3  public void init();\fP
+.fi     
+.nf     
+\f3  public void paint(java\&.awt\&.Graphics);\fP
+.fi     
+.nf     
+\f3}\fP
+.fi     
+.nf     
+\f3\fP
+.fi     
+.sp     
+The output from \f3javap -c DocFooter\&.class\fR command yields the following:
+.sp     
+.nf     
+\f3Compiled from "DocFooter\&.java"\fP
+.fi     
+.nf     
+\f3public class DocFooter extends java\&.applet\&.Applet {\fP
+.fi     
+.nf     
+\f3  java\&.lang\&.String date;\fP
+.fi     
+.nf     
+\f3  java\&.lang\&.String email;\fP
+.fi     
+.nf     
+\f3\fP
+.fi     
+.nf     
+\f3  public DocFooter();\fP
+.fi     
+.nf     
+\f3    Code:\fP
+.fi     
+.nf     
+\f3       0: aload_0       \fP
+.fi     
+.nf     
+\f3       1: invokespecial #1                  // Method\fP
+.fi     
+.nf     
+\f3java/applet/Applet\&."<init>":()V\fP
+.fi     
+.nf     
+\f3       4: return        \fP
+.fi     
+.nf     
+\f3\fP
+.fi     
+.nf     
+\f3  public void init();\fP
+.fi     
+.nf     
+\f3    Code:\fP
+.fi     
+.nf     
+\f3       0: aload_0       \fP
+.fi     
+.nf     
+\f3       1: sipush        500\fP
+.fi     
+.nf     
+\f3       4: bipush        100\fP
+.fi     
+.nf     
+\f3       6: invokevirtual #2                  // Method resize:(II)V\fP
+.fi     
+.nf     
+\f3       9: aload_0       \fP
+.fi     
+.nf     
+\f3      10: aload_0       \fP
+.fi     
+.nf     
+\f3      11: ldc           #3                  // String LAST_UPDATED\fP
+.fi     
+.nf     
+\f3      13: invokevirtual #4                  // Method\fP
+.fi     
+.nf     
+\f3 getParameter:(Ljava/lang/String;)Ljava/lang/String;\fP
+.fi     
+.nf     
+\f3      16: putfield      #5                  // Field date:Ljava/lang/String;\fP
+.fi     
+.nf     
+\f3      19: aload_0       \fP
+.fi     
+.nf     
+\f3      20: aload_0       \fP
+.fi     
+.nf     
+\f3      21: ldc           #6                  // String EMAIL\fP
+.fi     
+.nf     
+\f3      23: invokevirtual #4                  // Method\fP
+.fi     
+.nf     
+\f3 getParameter:(Ljava/lang/String;)Ljava/lang/String;\fP
+.fi     
+.nf     
+\f3      26: putfield      #7                  // Field email:Ljava/lang/String;\fP
+.fi     
+.nf     
+\f3      29: return        \fP
+.fi     
+.nf     
+\f3\fP
+.fi     
+.nf     
+\f3  public void paint(java\&.awt\&.Graphics);\fP
+.fi     
+.nf     
+\f3    Code:\fP
+.fi     
+.nf     
+\f3       0: aload_1       \fP
+.fi     
+.nf     
+\f3       1: new           #8                  // class java/lang/StringBuilder\fP
+.fi     
+.nf     
+\f3       4: dup           \fP
+.fi     
+.nf     
+\f3       5: invokespecial #9                  // Method\fP
+.fi     
+.nf     
+\f3 java/lang/StringBuilder\&."<init>":()V\fP
+.fi     
+.nf     
+\f3       8: aload_0       \fP
+.fi     
+.nf     
+\f3       9: getfield      #5                  // Field date:Ljava/lang/String;\fP
+.fi     
+.nf     
+\f3      12: invokevirtual #10                 // Method\fP
+.fi     
+.nf     
+\f3 java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;\fP
+.fi     
+.nf     
+\f3      15: ldc           #11                 // String  by \fP
+.fi     
+.nf     
+\f3      17: invokevirtual #10                 // Method\fP
+.fi     
+.nf     
+\f3 java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;\fP
+.fi     
+.nf     
+\f3      20: invokevirtual #12                 // Method\fP
+.fi     
+.nf     
+\f3 java/lang/StringBuilder\&.toString:()Ljava/lang/String;\fP
+.fi     
+.nf     
+\f3      23: bipush        100\fP
+.fi     
+.nf     
+\f3      25: bipush        15\fP
+.fi     
+.nf     
+\f3      27: invokevirtual #13                 // Method\fP
+.fi     
+.nf     
+\f3 java/awt/Graphics\&.drawString:(Ljava/lang/String;II)V\fP
+.fi     
+.nf     
+\f3      30: aload_1       \fP
+.fi     
+.nf     
+\f3      31: aload_0       \fP
+.fi     
+.nf     
+\f3      32: getfield      #7                  // Field email:Ljava/lang/String;\fP
+.fi     
+.nf     
+\f3      35: sipush        290\fP
+.fi     
+.nf     
+\f3      38: bipush        15\fP
+.fi     
+.nf     
+\f3      40: invokevirtual #13                 // Method\fP
+.fi     
+.nf     
+\f3java/awt/Graphics\&.drawString:(Ljava/lang/String;II)V\fP
+.fi     
+.nf     
+\f3      43: return        \fP
+.fi     
+.nf     
+\f3}\fP
+.fi     
+.nf     
+\f3\fP
+.fi     
+.sp     
+.SH SEE\ ALSO    
+.TP 0.2i    
+\(bu
+javac(1)
+.TP 0.2i    
+\(bu
+java(1)
+.TP 0.2i    
+\(bu
+jdb(1)
+.TP 0.2i    
+\(bu
+javah(1)
+.TP 0.2i    
+\(bu
+javadoc(1)
+.RE
+.br
+'pl 8.5i
+'bp

src/bsd/doc/man/jcmd.1

+'\" t
+.\"  Copyright (c) 2012, 2013, Oracle and/or its affiliates. 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
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"     Arch: generic
+.\"     Software: JDK 8
+.\"     Date: 21 November 2013
+.\"     SectDesc: Troubleshooting Tools
+.\"     Title: jcmd.1
+.\"
+.if n .pl 99999
+.TH jcmd 1 "21 November 2013" "JDK 8" "Troubleshooting Tools"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+
+.SH NAME    
+jcmd \- Sends diagnostic command requests to a running Java Virtual Machine (JVM)\&.
+.SH SYNOPSIS    
+.sp     
+.nf     
+
+\fBjcmd\fR [\fB\-l\fR|\fB\-h\fR|\fB\-help\fR]
+.fi     
+.nf     
+
+\fBjcmd\fR \fIpid\fR|\fImain\-class\fR \fBPerfCounter\&.print\fR
+.fi     
+.nf     
+
+\fBjcmd\fR \fIpid\fR|\fImain\-class\fR \fB\-f\fR \fIfilename\fR
+.fi     
+.nf     
+
+\fBjcmd\fR \fIpid\fR|\fImain\-class\fR \fIcommand\fR[ \fIarguments\fR]
+.fi     
+.sp     
+.SH DESCRIPTION    
+The \f3jcmd\fR utility is used to send diagnostic command requests to the JVM\&. It must be used on the same machine on which the JVM is running, and have the same effective user and group identifiers that were used to launch the JVM\&.
+.PP
+\fINote:\fR To invoke diagnostic commands from a remote machine or with different identiers, you can use the \f3com\&.sun\&.management\&.DiagnosticCommandMBean\fR interface\&. For more information about the \f3DiagnosticCommandMBean\fR interface, see the API documentation at http://download\&.java\&.net/jdk8/docs/jre/api/management/extension/com/sun/management/DiagnosticCommandMBean\&.html
+.PP
+If you run \f3jcmd\fR without arguments or with the \f3-l\fR option, it prints the list of running Java process identifiers with the main class and command-line arguments that were used to launch the process\&. Running \f3jcmd\fR with the \f3-h\fR or \f3-help\fR option prints the tool\(cqs help message\&.
+.PP
+If you specify the processes identifier (\fIpid\fR) or the main class (\fImain-class\fR) as the first argument, \f3jcmd\fR sends the diagnostic command request to the Java process with the specified identifier or to all Java processes with the specified name of the main class\&. You can also send the diagnostic command request to all available Java processes by specifying \f30\fR as the process identifier\&. Use one of the following as the diagnostic command request:
+.TP     
+Perfcounter\&.print
+Prints the performance counters available for the specified Java process\&. The list of performance counters might vary with the Java process\&.
+.TP
+-f \fIfilename\fR
+.br
+The name of the file from which to read diagnostic commands and send them to the specified Java process\&. Used only with the \f3-f\fR option\&. Each command in the file must be written on a single line\&. Lines starting with a number sign (\f3#\fR) are ignored\&. Processing of the file ends when all lines have been read or when a line containing the \f3stop\fR keyword is read\&.
+.TP     
+\fIcommand\fR [\fIarguments\fR]
+The command to be sent to the specified Java process\&. The list of available diagnostic commands for a given process can be obtained by sending the \f3help\fR command to this process\&. Each diagnostic command has its own set of arguments\&. To see the description, syntax, and a list of available arguments for a command, use the name of the command as the argument for the \f3help\fR command\&.
+
+\fINote:\fR If any arguments contain spaces, you must surround them with single or double quotation marks (\f3\&'\fR or \f3"\fR)\&. In addition, you must escape single or double quotation marks with a backslash (\f3\e\fR) to prevent the operating system shell from processing quotation marks\&. Alternatively, you can surround these arguments with single quotation marks and then with double quotation marks (or with double quotation marks and then with single quotation marks)\&.
+.SH OPTIONS    
+Options are mutually exclusive\&.
+.TP
+-f \fIfilename\fR
+.br
+Reads commands from the specified file\&. This option can be used only if you specify the process identifier or the main class as the first argument\&. Each command in the file must be written on a single line\&. Lines starting with a number sign (\f3#\fR) are ignored\&. Processing of the file ends when all lines have been read or when a line containing the \f3stop\fR keyword is read\&.
+.TP
+-h, -help
+.br
+Prints a help message\&.
+.TP
+-l
+.br
+Prints the list of running Java processes identifiers with the main class and command-line arguments\&.
+.SH SEE\ ALSO    
+.TP 0.2i    
+\(bu
+jps(1)
+.RE
+.br
+'pl 8.5i
+'bp

src/bsd/doc/man/jconsole.1

-." Copyright (c) 2004, 2012, Oracle and/or its affiliates. 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
-." under the terms of the GNU General Public License version 2 only, as
-." published by the Free Software Foundation.
-."
-." This code is distributed in the hope that it will be useful, but WITHOUT
-." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
-." version 2 for more details (a copy is included in the LICENSE file that
-." accompanied this code).
-."
-." You should have received a copy of the GNU General Public License version
-." 2 along with this work; if not, write to the Free Software Foundation,
-." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
-."
-." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
-." or visit www.oracle.com if you need additional information or have any
-." questions.
-."
-.TH jconsole 1 "10 May 2011"
+'\" t
+.\"  Copyright (c) 2004, 2013, Oracle and/or its affiliates. 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
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"     Arch: generic
+.\"     Software: JDK 8
+.\"     Date: 21 November 2013
+.\"     SectDesc: Java Troubleshooting, Profiling, Monitoring and Management Tools
+.\"     Title: jconsole.1
+.\"
+.if n .pl 99999
+.TH jconsole 1 "21 November 2013" "JDK 8" "Java Troubleshooting, Profiling, Monitoring and Management Tools"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
 
-.LP
-.SH "Name"
-jconsole \- Java Monitoring and Management Console
-.LP
-.SH "SYNOPSIS"
-.LP
-.nf
-\f3
-.fl
-\fP\f3jconsole\fP [ \f2options\fP ] [ connection ... ]
-.fl
+.SH NAME    
+jconsole \- Starts a graphical console that lets you monitor and manage Java applications\&.
+.SH SYNOPSIS    
+.sp     
+.nf     
 
-.fl
-.fi
+\fBjconsole\fR [ \fIoptions\fR ] [ connection \&.\&.\&. ]
+.fi     
+.sp     
+.TP     
+\fIoptions\fR
+The command-line options\&. See Options\&.
+.TP     
+connection = \fIpid\fR | \fIhost\fR:\fIport\fR | \fIjmxURL\fR
+The \f3pid\fR value is the process ID of a local Java Virtual Machine (JVM)\&. The JVM must be running with the same user ID as the user ID running the \f3jconsole\fR command\&.The \f3host:port\fR values are the name of the host system on which the JVM is running, and the port number specified by the system property \f3com\&.sun\&.management\&.jmxremote\&.port\fR when the JVM was started\&.The \f3jmxUrl\fR value is the address of the JMX agent to be connected to as described in JMXServiceURL\&.
 
-.LP
-.SH "PARAMETERS"
-.LP
-.RS 3
-.TP 3
-options
-Options, if used, should follow immediately after the command name.
-.TP 3
-connection = pid | host:port | jmxUrl
-.RS 3
-.TP 2
-o
-\f2pid\fP Process ID of a local Java VM. The Java VM must be running with the same user ID as the user ID running jconsole. See
-.na
-\f2JMX Monitoring and Management\fP @
-.fi
-http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.html for details.
-.TP 2
-o
-\f2host\fP:\f2port\fP Name of the host system on which the Java VM is running and the port number specified by the system property \f2com.sun.management.jmxremote.port\fP when the Java VM was started. See
-.na
-\f2JMX Monitoring and Management\fP @
-.fi
-http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.html for details.
-.TP 2
-o
-\f2jmxUrl\fP Address of the JMX agent to be connected to as described in
-.na
-\f2JMXServiceURL\fP @
-.fi
-http://download.oracle.com/javase/7/docs/api/javax/management/remote/JMXServiceURL.html.
-.RE
-.RE
+For more information about the \f3connection\fR parameter, see Monitoring and Management Using JMX Technology at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/management/agent\&.html
 
-.LP
-.SH "DESCRIPTION"
-.LP
-.LP
-The \f3jconsole\fP command launches a graphical console tool that enables you to monitor and manage Java applications and virtual machines on a local or remote machine.
-.LP
-.LP
-On Windows, \f3jconsole\fP does not associate with a console window. It will, however, display a dialog box with error information if the \f3jconsole\fP command fails for some reason.
-.LP
-.SH "OPTIONS"
-.LP
-.RS 3
-.TP 3
-\-interval=n
-Set the update interval to \f2n\fP seconds (default is 4 seconds).
-.TP 3
-\-notile
-Do not tile windows initially (for two or more connections).
-.TP 3
-\-pluginpath plugins
-Specify a list of directories or JAR files which are searched for JConsole plugins. The \f2plugins\fP path should contain a provider\-configuration file named:
+See also the \f3JMXServiceURL\fR class description at http://docs\&.oracle\&.com/javase/8/docs/api/javax/management/remote/JMXServiceURL\&.html
+.SH DESCRIPTION    
+The \f3jconsole\fR command starts a graphical console tool that lets you monitor and manage Java applications and virtual machines on a local or remote machine\&.
+.PP
+On Windows, the \f3jconsole\fR command does not associate with a console window\&. It does, however, display a dialog box with error information when the \f3jconsole\fR command fails\&.
+.SH OPTIONS    
+.TP
+-interval\fI=n\fR
 .br
-.nf
-\f3
-.fl
-   META\-INF/services/com.sun.tools.jconsole.JConsolePlugin
-.fl
-\fP
-.fi
-containing one line for each plugin specifying the fully qualified class name of the class implementing the
-.na
-\f2com.sun.tools.jconsole.JConsolePlugin\fP @
-.fi
-http://download.oracle.com/javase/7/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html class.
-.TP 3
-\-version
-Output version information and exit.
-.TP 3
-\-help
-Output help message and exit.
-.TP 3
-\-J<flag>
-Pass <flag> to the Java virtual machine on which jconsole is run.
-.RE
-
-.LP
-.SH "SEE ALSO"
-.LP
-.RS 3
-.TP 2
-o
-.na
-\f2Using JConsole\fP @
-.fi
-http://download.oracle.com/javase/7/docs/technotes/guides/management/jconsole.html
-.TP 2
-o
-.na
-\f2Monitoring and Management for Java Platform\fP @
-.fi
-http://download.oracle.com/javase/7/docs/technotes/guides/management/index.html
-.RE
-
-.LP
-
+Sets the update interval to \fIn\fR seconds (default is 4 seconds)\&.
+.TP
+-notile
+.br
+Does not tile windows initially (for two or more connections)\&.
+.TP
+-pluginpath \fIplugins\fR
+.br
+Specifies a list of directories or JAR files to be searched for \f3JConsole\fR plug-ins\&. The \fIplugins\fR path should contain a provider-configuration file named \f3META-INF/services/com\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fR that contains one line for each plug-in\&. The line specifies the fully qualified class name of the class implementing the \f3com\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fR class\&.
+.TP
+-version
+.br
+Displays release information and exits\&.
+.TP
+-help
+.br
+Displays a help message\&.
+.TP
+-J\fIflag\fR
+.br
+Passes \f3flag\fR to the JVM on which the \f3jconsole\fR command is run\&.
+.SH SEE\ ALSO    
+.TP 0.2i    
+\(bu
+Using JConsole at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/management/jconsole\&.html
+.TP 0.2i    
+\(bu
+Monitoring and Management Using JMX Technology at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/management/agent\&.html
+.TP 0.2i    
+\(bu
+The \f3JMXServiceURL\fR class description at http://docs\&.oracle\&.com/javase/8/docs/api/javax/management/remote/JMXServiceURL\&.html
+.RE
+.br
+'pl 8.5i
+'bp

src/bsd/doc/man/jsadebugd.1

-." Copyright (c) 2004, 2012, Oracle and/or its affiliates. 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
-." under the terms of the GNU General Public License version 2 only, as
-." published by the Free Software Foundation.
-."
-." This code is distributed in the hope that it will be useful, but WITHOUT
-." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
-." version 2 for more details (a copy is included in the LICENSE file that
-." accompanied this code).
-."
-." You should have received a copy of the GNU General Public License version
-." 2 along with this work; if not, write to the Free Software Foundation,
-." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
-."
-." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
-." or visit www.oracle.com if you need additional information or have any
-." questions.
-."
-.TH jsadebugd 1 "10 May 2011"
+'\" t
+.\"  Copyright (c) 2004, 2013, Oracle and/or its affiliates. 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
+.\" under the terms of the GNU General Public License version 2 only, as
+.\" published by the Free Software Foundation.
+.\"
+.\" This code is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" version 2 for more details (a copy is included in the LICENSE file that
+.\" accompanied this code).
+.\"
+.\" You should have received a copy of the GNU General Public License version
+.\" 2 along with this work; if not, write to the Free Software Foundation,
+.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+.\"
+.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+.\" or visit www.oracle.com if you need additional information or have any
+.\" questions.
+.\"
+.\"     Arch: generic
+.\"     Software: JDK 8
+.\"     Date: 21 November 2013
+.\"     SectDesc: Troubleshooting Tools
+.\"     Title: jsadebugd.1
+.\"
+.if n .pl 99999
+.TH jsadebugd 1 "21 November 2013" "JDK 8" "Troubleshooting Tools"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
 
-.LP
-.SH "Name"
-jsadebugd \- Serviceability Agent Debug Daemon
-.LP
-.SH "SYNOPSIS"
-.LP
-.nf
-\f3
-.fl
-\fP\f3jsadebugd\fP pid [ server\-id ]
-.fl
-\f3jsadebugd\fP executable core [ server\-id ]
-.fl
-.fi
+.SH NAME    
+jsadebugd \- Attaches to a Java process or core file and acts as a debug server\&. This command is experimental and unsupported\&.
+.SH SYNOPSIS    
+.sp     
+.nf     
 
-.LP
-.SH "PARAMETERS"
-.LP
-.RS 3
-.TP 3
-pid
-process id of the process to which the debug server should attach. The process must be a Java process. To get a list of Java processes running on a machine, jps(1) may be used. At most one instance of the debug server may be attached to a single process.
-.TP 3
-executable
-Java executable from which the core dump was produced
-.TP 3
-core
-Core file to which the debug server should attach.
-.TP 3
-server\-id
-Optional unique id, needed if multiple debug servers are started on the same machine. This ID must be used by remote clients to identify the particular debug server to attach. Within a single machine, this ID must be unique.
-.RE
+\fBjsadebugd\fR \fIpid\fR [ \fIserver\-id\fR ]
+.fi     
+.nf     
 
-.LP
-.SH "DESCRIPTION"
-.LP
-.LP
-\f3jsadebugd\fP attaches to a Java process or core file and acts as a debug server. Remote clients such as jstack(1), jmap(1), and jinfo(1) can attach to the server using Java Remote Method Invocation (RMI). Before starting \f2jsadebugd\fP,
-.na
-\f2rmiregistry\fP @
-.fi
-http://download.oracle.com/javase/7/docs/technotes/tools/index.html#rmi must be started with:
-.LP
-.nf
-\f3
-.fl
-\fP\f4rmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi.jar\fP\f3
-.fl
-\fP
-.fi
-
-.LP
-.LP
-where \f2$JAVA_HOME\fP is the JDK installation directory. If rmiregistry was not started, jsadebugd will start an rmiregistry in a standard (1099) port internally. Debug server may be stopped by sending SIGINT (pressing Ctrl\-C) to it.
-.LP
-.LP
-\f3NOTE\fP \- This utility is unsupported and may or may not be available in future versions of the JDK. In Windows Systems where dbgeng.dll is not present, 'Debugging Tools For Windows' needs to be installed to have these tools working. Also, \f2PATH\fP environment variable should contain the location of \f2jvm.dll\fP used by the target process or the location from which the Crash Dump file was produced.
-.LP
-.LP
-For example, \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
-.LP
-.SH "SEE ALSO"
-.LP
-.RS 3
-.TP 2
-o
+\fBjsadebugd\fR \fIexecutable\fR \fIcore\fR [ \fIserver\-id\fR ]
+.fi     
+.sp     
+.TP     
+\fIpid\fR
+The process ID of the process to which the debug server attaches\&. The process must be a Java process\&. To get a list of Java processes running on a machine, use the jps(1) command\&. At most one instance of the debug server can be attached to a single process\&.
+.TP     
+\fIexecutable\fR
+The Java executable from which the core dump was produced\&.
+.TP     
+\fIcore\fR
+The core file to which the debug server should attach\&.
+.TP     
+\fIserver-id\fR
+An optional unique ID that is needed when multiple debug servers are started on the same machine\&. This ID must be used by remote clients to identify the particular debug server to which to attach\&. Within a single machine, this ID must be unique\&.
+.SH DESCRIPTION    
+The \f3jsadebugd\fR command attaches to a Java process or core file and acts as a debug server\&. Remote clients such as \f3jstack\fR, \f3jmap\fR, and \f3jinfo\fR can attach to the server through Java Remote Method Invocation (RMI)\&. Before you start the \f3jsadebugd\fR command, start the RMI registry with the \f3rmiregistry\fR command as follows where \fI$JAVA_HOME\fR is the JDK installation directory:
+.sp     
+.nf     
+\f3rmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi\&.jar\fP
+.fi     
+.nf     
+\f3\fP
+.fi     
+.sp     
+If the RMI registry was not started, then the \f3jsadebugd\fR command starts an RMI registry in a standard (1099) port internally\&. The debug server can be stopped by sending a \f3SIGINT\fR to it\&. To send a SIGINT press \fICtrl+C\fR\&.
+.PP
+\fINote:\fR This utility is unsupported and may or may not be available in future releases of the JDK\&. In Windows Systems where \f3dbgeng\&.dll\fR is not present, Debugging Tools For Windows must be installed to have these tools working\&. The \f3PATH\fR environment variable should contain the location of jvm\&.dll used by the target process or the location from which the crash dump file was produced\&. For example, \f3s\fR\f3et PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR\&.
+.SH SEE\ ALSO    
+.TP 0.2i    
+\(bu
 jinfo(1)
-.TP 2
-o
+.TP 0.2i    
+\(bu
 jmap(1)
-.TP 2
-o
+.TP 0.2i    
+\(bu
 jps(1)
-.TP 2
-o
+.TP 0.2i    
+\(bu
 jstack(1)
-.TP 2
-o
-.na
-\f2rmiregistry\fP @
-.fi
-http://download.oracle.com/javase/7/docs/technotes/tools/index.html#rmi
-.RE
-
-.LP
-
+.TP 0.2i    
+\(bu
+rmiregistry(1)
+.RE
+.br
+'pl 8.5i
+'bp

src/macosx/classes/sun/awt/CGraphicsDevice.java

@@ -158,12 +158,12 @@ public final class CGraphicsDevice extends GraphicsDevice
         boolean fsSupported = isFullScreenSupported();
 
         if (fsSupported && old != null) {
-            // restore original display mode and enter windowed mode.
+            // enter windowed mode and restore original display mode
+            exitFullScreenExclusive(old);
             if (originalMode != null) {
                 setDisplayMode(originalMode);
                 originalMode = null;
             }
-            exitFullScreenExclusive(old);
         }
 
         super.setFullScreenWindow(w);
@@ -227,14 +227,10 @@ public final class CGraphicsDevice extends GraphicsDevice
             throw new IllegalArgumentException("Invalid display mode");
         }
         if (!Objects.equals(dm, getDisplayMode())) {
-            final Window w = getFullScreenWindow();
-            if (w != null) {
-                exitFullScreenExclusive(w);
-            }
             nativeSetDisplayMode(displayID, dm.getWidth(), dm.getHeight(),
-                                 dm.getBitDepth(), dm.getRefreshRate());
-            if (isFullScreenSupported() && w != null) {
-                enterFullScreenExclusive(w);
+                    dm.getBitDepth(), dm.getRefreshRate());
+            if (isFullScreenSupported() && getFullScreenWindow() != null) {
+                getFullScreenWindow().setSize(dm.getWidth(), dm.getHeight());
             }
         }
     }