OS/2 Shareware BBS: Java/Java.zip/jados155.zip/README.TXT

Text File | 1998-05-29 | 5KB | 134 lines

This is README file for Jad - the fast Java Decompiler.
Jad home page: http://web.unicom.com.cy/~kpd/jad.html
Copyright 1997-98 Pavel Kouznetsov.

0. Please read a disclaimer on Jad home page.

1. Installation.

Unzip jad.zip file into any appropriate directory on your hard drive.
This will create two files:

    - an executable file named 'jad.exe' (Windows 95/NT)
      or 'jad' (Linux)

    - this README file


No other setup is required.

2. How to use Jad

To decompile a single JAVA class file 'example1.class'
type the following:

     jad example1.class

This command will create file 'example1.jad' in the current directory.
If such file already exists Jad asks if you want to overwrite it.
Option -o allows overwriting without confirmations.

You can omit .class extension and/or use wildcards in the names of
input files.

Option -s <ext> allows to change output file extension:

     jad -sjava example1.class

This command will create file 'example1.java'. Be careful when using
options -o and -sjava together, because Jad can accidentally overwrite
your own source files.

Jad uses JAVA class name as an output file name. For example, if class
file 'example1.class' contains JAVA class 'test1' then Jad will create
file 'test1.jad' rather then 'example1.jad'. If you want to specify
your own output file name use output redirection:

   jad -p example1.class > myexm1.java

Option -d allows you to specify another directory for output files,
which are created, by default, in the current directory. For example:

   jad -o -dtest -sjava *.class

   (or jad -o -d test -s java *.class, which has the same effect)

This command will decompile all .class files in the current directory
and place all output files with extension .java into directory 'test'.


If you want to decompile the whole tree of JAVA classes, then
use the following command:

   jad -o -r -sjava -dsrc tree/**/*.class

This command will decompile all .class files located in all
subdirectories of 'tree' and create output files in subdirectories
of 'src' according to package names of classes. For example, if file
'tree/a/b/c.class' contains class 'c' from package 'a.b' then
output file will have a name 'src/a/b/c.java'.

Note the use of 'two asterisks' wildcard ('**') in the previous
command. It is handled by Jad rather then command shell, so on
UNIX the last argument should be single-quoted:

   jad -o -r -sjava -dsrc 'tree/**/*.class'


In case you want to check the accuracy of the decompilation or just
curious, there is an option -a which tells Jad to annotate the output
with JAVA Virtual Machine bytecodes.

Jad looks for the inner classes in the directory of their top-level
container class.

3. List of command-line options.

Jad accepts the following options:

   -a       - annotate the output with JVM bytecodes
   -af      - same as -a, but outputs fully qualified names when annotating;
   -b       - output redundant braces (e.g., if(a) { b(); }, default: no)
   -disass  - disassemble method bytecodes (no JAVA source generated)
   -d <dir> - directory for output files (will be created when necessary)
   -f       - output fully qualified names for classes/fields/methods
   -i       - output default initializers for all non-final fields
   -l<num>  - split strings into pieces of maximum <num> chars (default: no)
   -nl      - split strings on newline character (default: no)
   -o       - overwrite output files without confirmation
   -p       - send decompiled code to STDOUT (e.g., for piping)
   -r       - restore package directory structrure
   -s <ext> - output file extension (by default '.jad')
   -t       - use tabs instead of spaces for indentation
   -t<num>  - use <num> spaces for indentation (default: 4)
   -v       - display method names being decompiled
   -8       - convert UNICODE strings into 8-bit strings
              using current ANSI code page (Win32 only)

Other available options:

   -dead    - try to decompile dead parts of code (if any) (default: no)
   -inner   - turn off the support of inner classes (default: turned on)
   -ff      - output class fields before methods (default: after)
   -lvt     - ignore Local Variable Table information
   -nocast  - don't generate auxiliary casts
   -nocode  - don't generate the source code for methods
   -noctor  - suppress the empty constructors
   -nodos   - do not check for DOS mode of class file (default: check)
   -pi<num> - pack imports into one line after <num> imports (default: 3)
   -pv      - pack fields with identical types into one line (default: no)
   -pa <pfx>- prefix for all packages in generated source files
   -pc <pfx>- prefix for classes with numerical names (default: _cls)
   -pf <pfx>- prefix for fields with numerical names (default: _fld)
   -pe <pfx>- prefix for unused exception names (default: ex)
   -pl <pfx>- prefix for locals with numerical names (default: _lcl)
   -pm <pfx>- prefix for methods with numerical names (default: _mth)
   -pp <pfx>- prefix for method parms with numerical names (default: _prm)
   -stat    - display the total number of processed classes/methods/fields

All single-word options have three formats:

  -o    - 'negates' option value
  -o+   - set option value to 'true' or 'on'
  -o-   - set option value to 'false' or 'off'