--- old/src/bsd/doc/man/javap.1 2018-11-27 11:21:47.305920300 +0100 +++ /dev/null 2018-10-10 08:50:32.889292854 +0200 @@ -1,380 +0,0 @@ -'\" t -.\" Copyright (c) 1994, 2014, 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. -.\" -.\" Title: javap -.\" Language: English -.\" Date: 8 August 2014 -.\" SectDesc: Basic Tools -.\" Software: JDK 8 -.\" Arch: generic -.\" Part Number: E38207-03 -.\" -.if n .pl 99999 -.TH "javap" "1" "8 August 2014" "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 * -.\" ----------------------------------------------------------------- -.SH "NAME" -javap \- Disassembles one or more class files\&. -.SH "SYNOPSIS" -.sp -.if n \{\ -.RS 4 -.\} -.nf -\fBjavap\fR [\fIoptions\fR] \fIclassfile\fR\&.\&.\&. -.fi -.if n \{\ -.RE -.\} -.PP -\fIoptions\fR -.RS 4 -The command\-line options\&. See Options\&. -.RE -.PP -\fIclassfile\fR -.RS 4 -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 -\fBfile:///home/user/myproject/src/DocFooter\&.class\fR\&. -.RE -.SH "DESCRIPTION" -.PP -The -\fBjavap\fR -command disassembles one or more class files\&. The output depends on the options used\&. When no options are used, then the -\fBjavap\fR -command prints the package, protected and public fields, and methods of the classes passed to it\&. The -\fBjavap\fR -command prints its output to -\fBstdout\fR\&. -.SH "OPTIONS" -.PP -\-help -.br -\-\-help -.br -\-? -.RS 4 -Prints a help message for the -\fBjavap\fR -command\&. -.RE -.PP -\-version -.RS 4 -Prints release information\&. -.RE -.PP -\-l -.RS 4 -Prints line and local variable tables\&. -.RE -.PP -\-public -.RS 4 -Shows only public classes and members\&. -.RE -.PP -\-protected -.RS 4 -Shows only protected and public classes and members\&. -.RE -.PP -\-private -.br -\-p -.RS 4 -Shows all classes and members\&. -.RE -.PP -\-J\fIoption\fR -.RS 4 -Passes the specified option to the JVM\&. For example: -.sp -.if n \{\ -.RS 4 -.\} -.nf -\fBjavap \-J\-version\fR -\fBjavap \-J\-Djava\&.security\&.manager \-J\-Djava\&.security\&.policy=MyPolicy MyClassName\fR - -.fi -.if n \{\ -.RE -.\} -For more information about JVM options, see the command documentation\&. -.RE -.PP -\-s -.RS 4 -Prints internal type signatures\&. -.RE -.PP -\-sysinfo -.RS 4 -Shows system information (path, size, date, MD5 hash) of the class being processed\&. -.RE -.PP -\-constants -.RS 4 -Shows -\fBstatic final\fR -constants\&. -.RE -.PP -\-c -.RS 4 -Prints disassembled code, for example, the instructions that comprise the Java bytecodes, for each of the methods in the class\&. -.RE -.PP -\-verbose -.RS 4 -Prints stack size, number of locals and arguments for methods\&. -.RE -.PP -\-classpath \fIpath\fR -.RS 4 -Specifies the path the -\fBjavap\fR -command uses to look up classes\&. Overrides the default or the -\fBCLASSPATH\fR -environment variable when it is set\&. -.RE -.PP -\-bootclasspath \fIpath\fR -.RS 4 -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 -\fBjre/lib/rt\&.jar\fR -and several other JAR files\&. -.RE -.PP -\-extdir \fIdirs\fR -.RS 4 -Overrides the location at which installed extensions are searched for\&. The default location for extensions is the value of -\fBjava\&.ext\&.dirs\fR\&. -.RE -.SH "EXAMPLE" -.PP -Compile the following -\fBDocFooter\fR -class: -.sp -.if n \{\ -.RS 4 -.\} -.nf -\fBimport java\&.awt\&.*;\fR -\fBimport java\&.applet\&.*;\fR -\fB \fR -\fBpublic class DocFooter extends Applet {\fR -\fB String date;\fR -\fB String email;\fR -\fB \fR -\fB public void init() {\fR -\fB resize(500,100);\fR -\fB date = getParameter("LAST_UPDATED");\fR -\fB email = getParameter("EMAIL");\fR -\fB }\fR -\fB \fR -\fB public void paint(Graphics g) {\fR -\fB g\&.drawString(date + " by ",100, 15);\fR -\fB g\&.drawString(email,290,15);\fR -\fB }\fR -\fB}\fR - -.fi -.if n \{\ -.RE -.\} -.PP -The output from the -\fBjavap DocFooter\&.class\fR -command yields the following: -.sp -.if n \{\ -.RS 4 -.\} -.nf -\fBCompiled from "DocFooter\&.java"\fR -\fBpublic class DocFooter extends java\&.applet\&.Applet {\fR -\fB java\&.lang\&.String date;\fR -\fB java\&.lang\&.String email;\fR -\fB public DocFooter();\fR -\fB public void init();\fR -\fB public void paint(java\&.awt\&.Graphics);\fR -\fB}\fR - -.fi -.if n \{\ -.RE -.\} -.PP -The output from -\fBjavap \-c DocFooter\&.class\fR -command yields the following: -.sp -.if n \{\ -.RS 4 -.\} -.nf -\fBCompiled from "DocFooter\&.java"\fR -\fBpublic class DocFooter extends java\&.applet\&.Applet {\fR -\fB java\&.lang\&.String date;\fR -\fB java\&.lang\&.String email;\fR - -\fB public DocFooter();\fR -\fB Code:\fR -\fB 0: aload_0 \fR -\fB 1: invokespecial #1 // Method\fR -\fBjava/applet/Applet\&."":()V\fR -\fB 4: return \fR - -\fB public void init();\fR -\fB Code:\fR -\fB 0: aload_0 \fR -\fB 1: sipush 500\fR -\fB 4: bipush 100\fR -\fB 6: invokevirtual #2 // Method resize:(II)V\fR -\fB 9: aload_0 \fR -\fB 10: aload_0 \fR -\fB 11: ldc #3 // String LAST_UPDATED\fR -\fB 13: invokevirtual #4 // Method\fR -\fB getParameter:(Ljava/lang/String;)Ljava/lang/String;\fR -\fB 16: putfield #5 // Field date:Ljava/lang/String;\fR -\fB 19: aload_0 \fR -\fB 20: aload_0 \fR -\fB 21: ldc #6 // String EMAIL\fR -\fB 23: invokevirtual #4 // Method\fR -\fB getParameter:(Ljava/lang/String;)Ljava/lang/String;\fR -\fB 26: putfield #7 // Field email:Ljava/lang/String;\fR -\fB 29: return \fR - -\fB public void paint(java\&.awt\&.Graphics);\fR -\fB Code:\fR -\fB 0: aload_1 \fR -\fB 1: new #8 // class java/lang/StringBuilder\fR -\fB 4: dup \fR -\fB 5: invokespecial #9 // Method\fR -\fB java/lang/StringBuilder\&."":()V\fR -\fB 8: aload_0 \fR -\fB 9: getfield #5 // Field date:Ljava/lang/String;\fR -\fB 12: invokevirtual #10 // Method\fR -\fB java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;\fR -\fB 15: ldc #11 // String by \fR -\fB 17: invokevirtual #10 // Method\fR -\fB java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;\fR -\fB 20: invokevirtual #12 // Method\fR -\fB java/lang/StringBuilder\&.toString:()Ljava/lang/String;\fR -\fB 23: bipush 100\fR -\fB 25: bipush 15\fR -\fB 27: invokevirtual #13 // Method\fR -\fB java/awt/Graphics\&.drawString:(Ljava/lang/String;II)V\fR -\fB 30: aload_1 \fR -\fB 31: aload_0 \fR -\fB 32: getfield #7 // Field email:Ljava/lang/String;\fR -\fB 35: sipush 290\fR -\fB 38: bipush 15\fR -\fB 40: invokevirtual #13 // Method\fR -\fBjava/awt/Graphics\&.drawString:(Ljava/lang/String;II)V\fR -\fB 43: return \fR -\fB}\fR - -.fi -.if n \{\ -.RE -.\} -.SH "SEE ALSO" -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -java(1) -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -javac(1) -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -javadoc(1) -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -jdb(1) -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -jdeps(1) -.RE -.br -'pl 8.5i -'bp --- /dev/null 2018-10-10 08:50:32.889292854 +0200 +++ new/src/jdk.jdeps/share/man/javap.1 2018-11-27 11:21:46.861920303 +0100 @@ -0,0 +1,380 @@ +'\" t +.\" Copyright (c) 1994, 2014, 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. +.\" +.\" Title: javap +.\" Language: English +.\" Date: 8 August 2014 +.\" SectDesc: Basic Tools +.\" Software: JDK 8 +.\" Arch: generic +.\" Part Number: E38207-03 +.\" +.if n .pl 99999 +.TH "javap" "1" "8 August 2014" "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 * +.\" ----------------------------------------------------------------- +.SH "NAME" +javap \- Disassembles one or more class files\&. +.SH "SYNOPSIS" +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBjavap\fR [\fIoptions\fR] \fIclassfile\fR\&.\&.\&. +.fi +.if n \{\ +.RE +.\} +.PP +\fIoptions\fR +.RS 4 +The command\-line options\&. See Options\&. +.RE +.PP +\fIclassfile\fR +.RS 4 +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 +\fBfile:///home/user/myproject/src/DocFooter\&.class\fR\&. +.RE +.SH "DESCRIPTION" +.PP +The +\fBjavap\fR +command disassembles one or more class files\&. The output depends on the options used\&. When no options are used, then the +\fBjavap\fR +command prints the package, protected and public fields, and methods of the classes passed to it\&. The +\fBjavap\fR +command prints its output to +\fBstdout\fR\&. +.SH "OPTIONS" +.PP +\-help +.br +\-\-help +.br +\-? +.RS 4 +Prints a help message for the +\fBjavap\fR +command\&. +.RE +.PP +\-version +.RS 4 +Prints release information\&. +.RE +.PP +\-l +.RS 4 +Prints line and local variable tables\&. +.RE +.PP +\-public +.RS 4 +Shows only public classes and members\&. +.RE +.PP +\-protected +.RS 4 +Shows only protected and public classes and members\&. +.RE +.PP +\-private +.br +\-p +.RS 4 +Shows all classes and members\&. +.RE +.PP +\-J\fIoption\fR +.RS 4 +Passes the specified option to the JVM\&. For example: +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBjavap \-J\-version\fR +\fBjavap \-J\-Djava\&.security\&.manager \-J\-Djava\&.security\&.policy=MyPolicy MyClassName\fR + +.fi +.if n \{\ +.RE +.\} +For more information about JVM options, see the command documentation\&. +.RE +.PP +\-s +.RS 4 +Prints internal type signatures\&. +.RE +.PP +\-sysinfo +.RS 4 +Shows system information (path, size, date, MD5 hash) of the class being processed\&. +.RE +.PP +\-constants +.RS 4 +Shows +\fBstatic final\fR +constants\&. +.RE +.PP +\-c +.RS 4 +Prints disassembled code, for example, the instructions that comprise the Java bytecodes, for each of the methods in the class\&. +.RE +.PP +\-verbose +.RS 4 +Prints stack size, number of locals and arguments for methods\&. +.RE +.PP +\-classpath \fIpath\fR +.RS 4 +Specifies the path the +\fBjavap\fR +command uses to look up classes\&. Overrides the default or the +\fBCLASSPATH\fR +environment variable when it is set\&. +.RE +.PP +\-bootclasspath \fIpath\fR +.RS 4 +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 +\fBjre/lib/rt\&.jar\fR +and several other JAR files\&. +.RE +.PP +\-extdir \fIdirs\fR +.RS 4 +Overrides the location at which installed extensions are searched for\&. The default location for extensions is the value of +\fBjava\&.ext\&.dirs\fR\&. +.RE +.SH "EXAMPLE" +.PP +Compile the following +\fBDocFooter\fR +class: +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBimport java\&.awt\&.*;\fR +\fBimport java\&.applet\&.*;\fR +\fB \fR +\fBpublic class DocFooter extends Applet {\fR +\fB String date;\fR +\fB String email;\fR +\fB \fR +\fB public void init() {\fR +\fB resize(500,100);\fR +\fB date = getParameter("LAST_UPDATED");\fR +\fB email = getParameter("EMAIL");\fR +\fB }\fR +\fB \fR +\fB public void paint(Graphics g) {\fR +\fB g\&.drawString(date + " by ",100, 15);\fR +\fB g\&.drawString(email,290,15);\fR +\fB }\fR +\fB}\fR + +.fi +.if n \{\ +.RE +.\} +.PP +The output from the +\fBjavap DocFooter\&.class\fR +command yields the following: +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBCompiled from "DocFooter\&.java"\fR +\fBpublic class DocFooter extends java\&.applet\&.Applet {\fR +\fB java\&.lang\&.String date;\fR +\fB java\&.lang\&.String email;\fR +\fB public DocFooter();\fR +\fB public void init();\fR +\fB public void paint(java\&.awt\&.Graphics);\fR +\fB}\fR + +.fi +.if n \{\ +.RE +.\} +.PP +The output from +\fBjavap \-c DocFooter\&.class\fR +command yields the following: +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBCompiled from "DocFooter\&.java"\fR +\fBpublic class DocFooter extends java\&.applet\&.Applet {\fR +\fB java\&.lang\&.String date;\fR +\fB java\&.lang\&.String email;\fR + +\fB public DocFooter();\fR +\fB Code:\fR +\fB 0: aload_0 \fR +\fB 1: invokespecial #1 // Method\fR +\fBjava/applet/Applet\&."":()V\fR +\fB 4: return \fR + +\fB public void init();\fR +\fB Code:\fR +\fB 0: aload_0 \fR +\fB 1: sipush 500\fR +\fB 4: bipush 100\fR +\fB 6: invokevirtual #2 // Method resize:(II)V\fR +\fB 9: aload_0 \fR +\fB 10: aload_0 \fR +\fB 11: ldc #3 // String LAST_UPDATED\fR +\fB 13: invokevirtual #4 // Method\fR +\fB getParameter:(Ljava/lang/String;)Ljava/lang/String;\fR +\fB 16: putfield #5 // Field date:Ljava/lang/String;\fR +\fB 19: aload_0 \fR +\fB 20: aload_0 \fR +\fB 21: ldc #6 // String EMAIL\fR +\fB 23: invokevirtual #4 // Method\fR +\fB getParameter:(Ljava/lang/String;)Ljava/lang/String;\fR +\fB 26: putfield #7 // Field email:Ljava/lang/String;\fR +\fB 29: return \fR + +\fB public void paint(java\&.awt\&.Graphics);\fR +\fB Code:\fR +\fB 0: aload_1 \fR +\fB 1: new #8 // class java/lang/StringBuilder\fR +\fB 4: dup \fR +\fB 5: invokespecial #9 // Method\fR +\fB java/lang/StringBuilder\&."":()V\fR +\fB 8: aload_0 \fR +\fB 9: getfield #5 // Field date:Ljava/lang/String;\fR +\fB 12: invokevirtual #10 // Method\fR +\fB java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;\fR +\fB 15: ldc #11 // String by \fR +\fB 17: invokevirtual #10 // Method\fR +\fB java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;\fR +\fB 20: invokevirtual #12 // Method\fR +\fB java/lang/StringBuilder\&.toString:()Ljava/lang/String;\fR +\fB 23: bipush 100\fR +\fB 25: bipush 15\fR +\fB 27: invokevirtual #13 // Method\fR +\fB java/awt/Graphics\&.drawString:(Ljava/lang/String;II)V\fR +\fB 30: aload_1 \fR +\fB 31: aload_0 \fR +\fB 32: getfield #7 // Field email:Ljava/lang/String;\fR +\fB 35: sipush 290\fR +\fB 38: bipush 15\fR +\fB 40: invokevirtual #13 // Method\fR +\fBjava/awt/Graphics\&.drawString:(Ljava/lang/String;II)V\fR +\fB 43: return \fR +\fB}\fR + +.fi +.if n \{\ +.RE +.\} +.SH "SEE ALSO" +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +java(1) +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +javac(1) +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +javadoc(1) +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +jdb(1) +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +jdeps(1) +.RE +.br +'pl 8.5i +'bp