PC World 2000 February/PCWorld_2000-02_cd.bin/Software/TemaCD/njvc/_SETUP.1/Readme.txt

Text File | 1999-07-07 | 6KB | 140 lines

This is README file for Jad - the fast Java Decompiler.
Jad home page: http://www.geocities.com/SiliconValley/Bridge/8617/jad.html
Copyright 1997-99 Pavel Kouznetsov ([e-mail]).

0. Please read the disclaimer on the 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 supports inner and anonymous classes. When Jad expands wildcards
in the input file names, it automatically skips matching inner classes.
On UNIX Jad skips inner classes if there is more than one class specified
in the command line.
Jad looks for inner classes in the directory of their top-level
container class.

3. List of the 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;
   -clear   - clears all prefixes, including the default ones (can be abbreviated as -cl)
   -b       - output redundant braces (e.g., if(a) { b(); }, default: no)
   -d <dir> - directory for output files (will be created when necessary)
   -dead    - try to decompile dead parts of code (if any) (default: no)
   -disass  - disassemble method bytecodes (no JAVA source generated)
   -f       - output fully qualified names for classes/fields/methods
   -ff      - output class fields before methods (default: after 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)
   -nodos   - do not check for class files in DOS mode (default: check)
   -nocast  - don't generate auxiliary casts
   -nocode  - don't generate the source code for methods
   -noconv  - don't convert Java identifiers (default: do)
   -noctor  - suppress the empty constructors
   -noinner - turn off the support of inner classes (default: turn on)
   -nolvt   - ignore Local Variable Table information
   -nonlb   - don't output a newline before opening brace (default: do)
   -o       - overwrite output files without confirmation (default: no)
   -p       - send decompiled code to STDOUT (e.g., for piping)
   -pi<num> - pack imports into one line after <num> imports (default: 3)
   -pv<num> - 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)
   -r       - restore package directory structrure
   -s <ext> - output file extension (by default '.jad')
   -stat    - display the total number of processed classes/methods/fields
   -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)
   -&       - redirect stderr to stdout (Win32 only)

All single-word options have three formats:

  -o    - 'reverses' value of an option
  -o+   - set value to 'true' or 'on'
  -o-   - set value to 'false' or 'off'