summaryrefslogtreecommitdiff
path: root/gnu/classpath/tools/README
blob: a5865b6dab2964d86fdf45320c5349bfecf65d72 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
The classes in this directory attempt to provide tools similar to 
Sun's javap and javah tools.  These classes rely heavily on the gnu.bytecode
package that is available from http://www.gnu.org/software/kawa/.  Limited
testing has been performed to find the most obvious problems.  The most
likely way to find additional problems with these tools will be with 
a class that makes heavy use of UNICODE for names of classes, functions, 
and fields along with inner classes or inner classes.  If you find a
a problem, please try to submit a concise test case that will make 
it possible to reproduce the problem along with expected output.

<java> gnu.classpath.tools.JavapMain

OR

<java> gnu.classpath.tools.JavahMain

Specifying a class can be done in the following ways:

* java.lang.Exception
* java/lang/Exception
* java/lang/Exception.class

Search order is to look for an existing file from the current directory,
then to use the user specified CLASSPATH if it exists, or to try loading t
hrough the class library class loader via Class.forName().  This final 
method falls back on trying to load via the system boot CLASSPATH and
CLASSPATH combination by reading the class stream when Class.forName() fails.

Known Problems

Javah-Like Functionality

* Some fields that are inherited from super classes 
  are not properly defined.
* Some headers should have a serialVersionUID even though 
  the class contains no such field, presumably as an aid
  to native code to avoid the calculation.

Javap-Like Functionality

* No serious problems are known.