jdk/src/linux/doc/man/javap.1
changeset 9573 c02ff5a7c67b
parent 5865 47da38a8c0f0
child 21743 3d979da7bdf0
--- a/jdk/src/linux/doc/man/javap.1	Tue May 10 19:57:30 2011 -0700
+++ b/jdk/src/linux/doc/man/javap.1	Wed May 11 08:30:46 2011 -0700
@@ -1,4 +1,4 @@
-." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1994, 2011, 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
@@ -19,27 +19,21 @@
 ." or visit www.oracle.com if you need additional information or have any
 ." questions.
 ."
-.TH javap 1 "02 Jun 2010"
+.TH javap 1 "10 May 2011"
 
 .LP
 .SH "Name"
 javap \- The Java Class File Disassembler
 .LP
-.RS 3
-
-.LP
 .LP
 Disassembles class files.
 .LP
-.RE
 .SH "SYNOPSIS"
 .LP
-
-.LP
 .nf
 \f3
 .fl
-javap [ \fP\f3options\fP\f3 ] class. . .
+javap [ \fP\f3options\fP\f3 ] classes
 .fl
 \fP
 .fi
@@ -47,13 +41,21 @@
 .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
 
 .LP
 .LP
-The \f3javap\fP command disassembles a class file. 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. For example, compile the following class declaration:
-.LP
-.RS 3
-
+For example, compile the following class declaration:
 .LP
 .nf
 \f3
@@ -96,166 +98,160 @@
 .fl
 \fP
 .fi
-.RE
 
 .LP
 .LP
-The output from \f3javap DocFooter\fP yields:
-.LP
-.RS 3
-
+The output from \f3javap DocFooter.class\fP yields:
 .LP
 .nf
 \f3
 .fl
-Compiled from DocFooter.java
+Compiled from "DocFooter.java"
 .fl
 public class DocFooter extends java.applet.Applet {
 .fl
-    java.lang.String date;
+  java.lang.String date;
 .fl
-    java.lang.String email;
+  java.lang.String email;
 .fl
-    public DocFooter();
+  public DocFooter();
 .fl
-    public void init();
+  public void init();
 .fl
-    public void paint(java.awt.Graphics);
+  public void paint(java.awt.Graphics);
 .fl
 }
 .fl
 \fP
 .fi
-.RE
 
 .LP
 .LP
-The output from \f3javap \-c DocFooter\fP yields:
-.LP
-.RS 3
-
+The output from \f3javap \-c DocFooter.class\fP yields:
 .LP
 .nf
 \f3
 .fl
-Compiled from DocFooter.java
+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();
+  java.lang.String date;
 .fl
-    public void init();
+
 .fl
-    public void paint(java.awt.Graphics);
-.fl
-}
+  java.lang.String email;
 .fl
 
 .fl
-Method DocFooter()
+  public DocFooter();
 .fl
-   0 aload_0
+    Code:
 .fl
-   1 invokespecial #1 <Method java.applet.Applet()>
+       0: aload_0       
 .fl
-   4 return
+       1: invokespecial #1                  // Method java/applet/Applet."<init>":()V
+.fl
+       4: return        
 .fl
 
 .fl
-Method void init()
+  public void init();
 .fl
-   0 aload_0
+    Code:
 .fl
-   1 sipush 500
+       0: aload_0       
 .fl
-   4 bipush 100
+       1: sipush        500
 .fl
-   6 invokevirtual #2 <Method void resize(int, int)>
+       4: bipush        100
 .fl
-   9 aload_0
+       6: invokevirtual #2                  // Method resize:(II)V
 .fl
-  10 aload_0
+       9: aload_0       
 .fl
-  11 ldc #3 <String "LAST_UPDATED">
+      10: aload_0       
 .fl
-  13 invokevirtual #4 <Method java.lang.String getParameter(java.lang.String)>
+      11: ldc           #3                  // String LAST_UPDATED
 .fl
-  16 putfield #5 <Field java.lang.String date>
+      13: invokevirtual #4                  // Method getParameter:(Ljava/lang/String;)Ljava/lang/String;
 .fl
-  19 aload_0
+      16: putfield      #5                  // Field date:Ljava/lang/String;
 .fl
-  20 aload_0
+      19: aload_0       
 .fl
-  21 ldc #6 <String "EMAIL">
+      20: aload_0       
 .fl
-  23 invokevirtual #4 <Method java.lang.String getParameter(java.lang.String)>
+      21: ldc           #6                  // String EMAIL
 .fl
-  26 putfield #7 <Field java.lang.String email>
+      23: invokevirtual #4                  // Method getParameter:(Ljava/lang/String;)Ljava/lang/String;
 .fl
-  29 return
+      26: putfield      #7                  // Field email:Ljava/lang/String;
+.fl
+      29: return        
 .fl
 
 .fl
-Method void paint(java.awt.Graphics)
+  public void paint(java.awt.Graphics);
 .fl
-   0 aload_1
+    Code:
 .fl
-   1 new #8 <Class java.lang.StringBuffer>
+       0: aload_1       
 .fl
-   4 dup
+       1: new           #8                  // class java/lang/StringBuilder
 .fl
-   5 invokespecial #9 <Method java.lang.StringBuffer()>
+       4: dup           
 .fl
-   8 aload_0
+       5: invokespecial #9                  // Method java/lang/StringBuilder."<init>":()V
 .fl
-   9 getfield #5 <Field java.lang.String date>
+       8: aload_0       
+.fl
+       9: getfield      #5                  // Field date:Ljava/lang/String;
 .fl
-  12 invokevirtual #10 <Method java.lang.StringBuffer append(java.lang.String)>
+      12: invokevirtual #10                 // Method java/lang/StringBuilder.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;
 .fl
-  15 ldc #11 <String " by ">
+      15: ldc           #11                 // String  by 
 .fl
-  17 invokevirtual #10 <Method java.lang.StringBuffer append(java.lang.String)>
+      17: invokevirtual #10                 // Method java/lang/StringBuilder.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;
 .fl
-  20 invokevirtual #12 <Method java.lang.String toString()>
+      20: invokevirtual #12                 // Method java/lang/StringBuilder.toString:()Ljava/lang/String;
 .fl
-  23 bipush 100
+      23: bipush        100
+.fl
+      25: bipush        15
 .fl
-  25 bipush 15
+      27: invokevirtual #13                 // Method java/awt/Graphics.drawString:(Ljava/lang/String;II)V
 .fl
-  27 invokevirtual #13 <Method void drawString(java.lang.String, int, int)>
+      30: aload_1       
 .fl
-  30 aload_1
+      31: aload_0       
 .fl
-  31 aload_0
+      32: getfield      #7                  // Field email:Ljava/lang/String;
 .fl
-  32 getfield #7 <Field java.lang.String email>
+      35: sipush        290
 .fl
-  35 sipush 290
+      38: bipush        15
 .fl
-  38 bipush 15
+      40: invokevirtual #13                 // Method java/awt/Graphics.drawString:(Ljava/lang/String;II)V
 .fl
-  40 invokevirtual #13 <Method void drawString(java.lang.String, int, int)>
+      43: return        
 .fl
-  43 return
+}
 .fl
 \fP
 .fi
-.RE
 
 .LP
 .SH "OPTIONS"
 .LP
-
-.LP
 .RS 3
 .TP 3
-\-help 
+\-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
@@ -268,14 +264,11 @@
 \-package 
 Shows only package, protected, and public classes and members. This is the default. 
 .TP 3
-\-private 
+\-private \-p 
 Shows all classes and members. 
 .TP 3
 \-Jflag 
 Pass \f2flag\fP directly to the runtime system. Some examples: 
-.RS 3
-
-.LP
 .nf
 \f3
 .fl
@@ -285,11 +278,16 @@
 .fl
 \fP
 .fi
-.RE
 .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
@@ -301,22 +299,7 @@
 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. 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
+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. 
@@ -326,32 +309,8 @@
 .RE
 
 .LP
-.SH "ENVIRONMENT VARIABLES"
-.LP
-
-.LP
-.RS 3
-.TP 3
-CLASSPATH 
-Used to provide the system a path to user\-defined classes. Directories are separated by colons, for example, For example: 
-.RS 3
-
-.LP
-.nf
-\f3
-.fl
-.:/home/avh/classes:/usr/local/java/classes
-.fl
-\fP
-.fi
-.RE
-.RE
-
-.LP
 .SH "SEE ALSO"
 .LP
-
-.LP
 .LP
 javac(1), java(1), jdb(1), javah(1), javadoc(1)
 .LP