Sun Microsystems 2 Tablet Accessory User Manual


 
16 Signature Test Tool 2.0 User’s Guide April 2008
Case Sensitivity of Command Arguments
The specification of each argument flag at the command line is not case sensitive, but
the input value entered immediately after the argument flag is case sensitive.
The following two command lines produce identical results for the -FileName flag:
% java com.sun.tdk.signaturetest.Setup -FileName name.sig
% java com.sun.tdk.signaturetest.Setup -filename name.sig
However, these two might not produce identical results if the host operating system
is case sensitive to the file name values entered:
% java com.sun.tdk.signaturetest.Setup -FileName name.sig
% java com.sun.tdk.signaturetest.Setup -FileName NAME.sig
Signature File Formats
The SigTest tool has changed signature file formats through progressive versions.
TABLE 2-3 lists the existing signature file formats and describes how each relates to a
specific SigTest tool version. In SigTest tool 1.5, the SignatureTest and Merge
commands read v2.1 and later signature files, and output only v4.0. The v4.0 file
format supports added functionality, such as generics and annotations.
TABLE 2-3 Signature File Format Compatibility
Format Description
v0 Generates a signature file with simple class member names. This was
the default format in SigTest tool 1.0, but is not supported by
SignatureTest command in SigTest tool 1.3 and later.
v1 Generates a signature file with fully qualified class member names.
This was the default format in SigTest tool 1.1. This format includes
non-normalized exception throw lists for constructors and methods.
Normalizing the throw list involves removing all superfluous
exception classes. A class is superfluous if it is a subclass of either
the
java.lang.RuntimeException class, or the
java.lang.Error class, or another class from the same list. This
format is not supported by
SignatureTest command in SigTest
tool 1.3 and later.
v2 This is the default format for SigTest tool 1.2. Generates a signature
file with fully qualified class member names and modified
supr
statements. This format includes normalized exception throw lists for
constructors and methods. This format is not supported by
SignatureTest command in SigTest tool 1.3 and later.