This is README file for JAD - the fast JAva Decompiler.

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
   -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


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)
   -lvt     - ignore Local Variable Table information
   -nocast  - don't generate auxiliary casts
   -noctor  - suppress the empty constructors
   -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'
