--- old/src/jdk.jdeps/share/man/javap.1 2019-05-31 13:32:06.221376254 -0700 +++ new/src/jdk.jdeps/share/man/javap.1 2019-05-31 13:32:05.957376263 -0700 @@ -1,5 +1,4 @@ -'\" t -.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. +.\" Copyright (c) 1994, 2019, 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 @@ -20,361 +19,257 @@ .\" 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 +.\" Automatically generated by Pandoc 2.3.1 .\" -.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 -.\} +.TH "JAVAP" "1" "2018" "JDK 13" "JDK Commands" +.hy +.SH NAME +.PP +javap \- disassemble one or more class files +.SH SYNOPSIS +.PP +\f[CB]javap\f[R] [\f[I]options\f[R]] \f[I]classes\f[R]... +.TP +.B \f[I]options\f[R] +Specifies the command\-line options. +See \f[B]Options for javap\f[R]. +.RS +.RE +.TP +.B \f[I]classes\f[R] +Specifies one or more classes separated by spaces to be processed for +annotations. +You can specify a class that can be found in the class path by its file +name, URL, or by its fully qualified class name. +.RS +.PP +Examples: +.RS +.PP +\f[CB]path/to/MyClass.class\f[R] +.RE +.RS +.PP +\f[CB]jar:file:///path/to/MyJar.jar!/mypkg/MyClass.class\f[R] +.RE +.RS +.PP +\f[CB]java.lang.Object\f[R] +.RE +.RE +.SH DESCRIPTION +.PP +The \f[CB]javap\f[R] command disassembles one or more class files. +The output depends on the options used. +When no options are used, the \f[CB]javap\f[R] command prints the +protected and public fields, and methods of the classes passed to it. +.PP +The \f[CB]javap\f[R] command isn\[aq]t multirelease JAR aware. +Using the class path form of the command results in viewing the base +entry in all JAR files, multirelease or not. +Using the URL form, you can use the URL form of an argument to specify a +specific version of a class to be disassembled. +.PP +The \f[CB]javap\f[R] command prints its output to \f[CB]stdout\f[R]. +.PP +\f[B]Note:\f[R] +.PP +In tools that support \f[CB]\-\-\f[R] style options, the GNU\-style +options can use the equal sign (\f[CB]=\f[R]) instead of a white space to +separate the name of an option from its value. +.SH OPTIONS FOR JAVAP +.TP +.B \f[CB]\-help\f[R], \f[CB]\-\-help\f[R] , or \f[CB]\-?\f[R] +Prints a help message for the \f[CB]javap\f[R] command. +.RS +.RE +.TP +.B \f[CB]\-version\f[R] +Prints release information. +.RS +.RE +.TP +.B \f[CB]\-verbose\f[R] or \f[CB]\-v\f[R] +Prints additional information about the selected class. +.RS +.RE +.TP +.B \f[CB]\-l\f[R] +Prints line and local variable tables. +.RS +.RE +.TP +.B \f[CB]\-public\f[R] +Shows only public classes and members. +.RS +.RE +.TP +.B \f[CB]\-protected\f[R] +Shows only protected and public classes and members. +.RS +.RE +.TP +.B \f[CB]\-package\f[R] +Shows package/protected/public classes and members (default). +.RS +.RE +.TP +.B \f[CB]\-private\f[R] or \f[CB]\-p\f[R] +Shows all classes and members. +.RS +.RE +.TP +.B \f[CB]\-c\f[R] +Prints disassembled code, for example, the instructions that comprise +the Java bytecodes, for each of the methods in the class. +.RS +.RE +.TP +.B \f[CB]\-s\f[R] +Prints internal type signatures. +.RS +.RE +.TP +.B \f[CB]\-sysinfo\f[R] +Shows system information (path, size, date, MD5 hash) of the class being +processed. +.RS +.RE +.TP +.B \f[CB]\-constants\f[R] +Shows \f[CB]static\ final\f[R] constants. +.RS +.RE +.TP +.B \f[CB]\-\-module\f[R] \f[I]module\f[R] or \f[CB]\-m\f[R] \f[I]module\f[R] +Specifies the module containing classes to be disassembled. +.RS +.RE +.TP +.B \f[CB]\-\-module\-path\f[R] \f[I]path\f[R] +Specifies where to find application modules. +.RS +.RE +.TP +.B \f[CB]\-\-system\f[R] \f[I]jdk\f[R] +Specifies where to find system modules. +.RS +.RE +.TP +.B \f[CB]\-\-class\-path\f[R] \f[I]path\f[R], \f[CB]\-classpath\f[R] \f[I]path\f[R], or \f[CB]\-cp\f[R] \f[I]path\f[R] +Specifies the path that the \f[CB]javap\f[R] command uses to find user +class files. +It overrides the default or the \f[CB]CLASSPATH\f[R] environment variable +when it\[aq]s set. +.RS +.RE +.TP +.B \f[CB]\-bootclasspath\f[R] \f[I]path\f[R] +Overrides the location of bootstrap class files. +.RS +.RE +.TP +.B \f[CB]\-J\f[R]\f[I]option\f[R] +Passes the specified option to the JVM. +For example: +.RS +.IP .nf -\fBjavap\fR [\fIoptions\fR] \fIclassfile\fR\&.\&.\&. +\f[CB] +javap\ \-J\-version + +javap\ \-J\-Djava.security.manager\ \-J\-Djava.security.policy=MyPolicy\ MyClassName +\f[R] .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\&. +See \f[I]Overview of Java Options\f[R] in \f[B]java\f[R]. .RE +.SH JAVAP EXAMPLE .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 -.\} +Compile the following \f[CB]HelloWorldFrame\f[R] class: +.IP .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 - +\f[CB] +import\ java.awt.Graphics; + +import\ javax.swing.JFrame; +import\ javax.swing.JPanel; + +public\ class\ HelloWorldFrame\ extends\ JFrame\ { + +\ \ \ String\ message\ =\ "Hello\ World!"; + +\ \ \ public\ HelloWorldFrame(){ +\ \ \ \ \ \ \ \ setContentPane(new\ JPanel(){ +\ \ \ \ \ \ \ \ \ \ \ \ \@Override +\ \ \ \ \ \ \ \ \ \ \ \ protected\ void\ paintComponent(Graphics\ g)\ { +\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ g.drawString(message,\ 15,\ 30); +\ \ \ \ \ \ \ \ \ \ \ \ } +\ \ \ \ \ \ \ \ }); +\ \ \ \ \ \ \ \ setSize(100,\ 100); +\ \ \ \ } +\ \ \ \ public\ static\ void\ main(String[]\ args)\ { +\ \ \ \ \ \ \ \ HelloWorldFrame\ frame\ =\ new\ HelloWorldFrame(); +\ \ \ \ \ \ \ \ frame.setVisible(true); + +\ \ \ \ } + +} +\f[R] .fi -.if n \{\ -.RE -.\} .PP -The output from the -\fBjavap DocFooter\&.class\fR -command yields the following: -.sp -.if n \{\ -.RS 4 -.\} +The output from the \f[CB]javap\ HelloWorldFrame.class\f[R] command yields +the following: +.IP .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 - +\f[CB] +Compiled\ from\ "HelloWorldFrame.java" +public\ class\ HelloWorldFrame\ extends\ javax.swing.JFrame\ { +\ \ java.lang.String\ message; +\ \ public\ HelloWorldFrame(); +\ \ public\ static\ void\ main(java.lang.String[]); +} +\f[R] .fi -.if n \{\ -.RE -.\} .PP -The output from -\fBjavap \-c DocFooter\&.class\fR -command yields the following: -.sp -.if n \{\ -.RS 4 -.\} +The output from the \f[CB]javap\ \-c\ HelloWorldFrame.class\f[R] command +yields the following: +.IP .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 - +\f[CB] +Compiled\ from\ "HelloWorldFrame.java" +public\ class\ HelloWorldFrame\ extends\ javax.swing.JFrame\ { +\ \ java.lang.String\ message; + +\ \ public\ HelloWorldFrame(); +\ \ \ \ Code: +\ \ \ \ \ \ \ 0:\ aload_0 +\ \ \ \ \ \ \ 1:\ invokespecial\ #1\ \ \ \ \ \ \ \ //\ Method\ javax/swing/JFrame."":()V +\ \ \ \ \ \ \ 4:\ aload_0 +\ \ \ \ \ \ \ 5:\ ldc\ \ \ \ \ \ \ \ \ \ \ #2\ \ \ \ \ \ \ \ //\ String\ Hello\ World! +\ \ \ \ \ \ \ 7:\ putfield\ \ \ \ \ \ #3\ \ \ \ \ \ \ \ //\ Field\ message:Ljava/lang/String; +\ \ \ \ \ \ 10:\ aload_0 +\ \ \ \ \ \ 11:\ new\ \ \ \ \ \ \ \ \ \ \ #4\ \ \ \ \ \ \ \ //\ class\ HelloWorldFrame$1 +\ \ \ \ \ \ 14:\ dup +\ \ \ \ \ \ 15:\ aload_0 +\ \ \ \ \ \ 16:\ invokespecial\ #5\ \ \ \ \ \ \ \ //\ Method\ HelloWorldFrame$1."":(LHelloWorldFrame;)V +\ \ \ \ \ \ 19:\ invokevirtual\ #6\ \ \ \ \ \ \ \ //\ Method\ setContentPane:(Ljava/awt/Container;)V +\ \ \ \ \ \ 22:\ aload_0 +\ \ \ \ \ \ 23:\ bipush\ \ \ \ \ \ \ \ 100 +\ \ \ \ \ \ 25:\ bipush\ \ \ \ \ \ \ \ 100 +\ \ \ \ \ \ 27:\ invokevirtual\ #7\ \ \ \ \ \ \ \ //\ Method\ setSize:(II)V +\ \ \ \ \ \ 30:\ return + +\ \ public\ static\ void\ main(java.lang.String[]); +\ \ \ \ Code: +\ \ \ \ \ \ \ 0:\ new\ \ \ \ \ \ \ \ \ \ \ #8\ \ \ \ \ \ \ \ //\ class\ HelloWorldFrame +\ \ \ \ \ \ \ 3:\ dup +\ \ \ \ \ \ \ 4:\ invokespecial\ #9\ \ \ \ \ \ \ \ //\ Method\ "":()V +\ \ \ \ \ \ \ 7:\ astore_1 +\ \ \ \ \ \ \ 8:\ aload_1 +\ \ \ \ \ \ \ 9:\ iconst_1 +\ \ \ \ \ \ 10:\ invokevirtual\ #10\ \ \ \ \ \ \ //\ Method\ setVisible:(Z)V +\ \ \ \ \ \ 13:\ return +} +\f[R] .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