~ubuntu-branches/ubuntu/maverick/proguard/maverick

« back to all changes in this revision

Viewing changes to docs/manual/troubleshooting.html

  • Committer: Bazaar Package Importer
  • Author(s): Sam Clegg, Onkar Shinde, Sam Clegg
  • Date: 2009-10-09 16:17:49 UTC
  • mfrom: (1.2.3 upstream) (3.1.6 karmic)
  • Revision ID: james.westby@ubuntu.com-20091009161749-qjk059y5r792co7c
Tags: 4.4-1
[ Onkar Shinde ]
* Merge from Ubuntu. (Closes: #534029, #548810)

[ Sam Clegg ]
* Thanks Onkar for the above fixes!
* New upstream release

Show diffs side-by-side

added added

removed removed

Lines of Context:
22
22
<li><a href="#duplicateclass">Note: duplicate definition of program/library class</a></li>
23
23
<li><a href="#duplicatezipentry">Warning: can't write resource ... Duplicate zip entry</a></li>
24
24
<li><a href="#unresolvedclass">Warning: can't find superclass or interface</a></li>
 
25
<li><a href="#unresolvedclass">Warning: can't find referenced class</a></li>
25
26
<li><a href="#unresolvedclassmember">Warning: can't find referenced field/method</a></li>
26
27
<li><a href="#unresolvedenclosingmethod">Warning: can't find enclosing class/method</a></li>
27
28
<li><a href="#dependency">Warning: library class ... depends on program class ...</a></li>
143
144
some more serious warnings:
144
145
 
145
146
<dl>
146
 
<dt><a name="unresolvedclass"><b>Warning: can't find superclass or interface</b></a></dt>
 
147
<dt><a name="unresolvedclass"><b>Warning: can't find superclass or interface</b><br/><b>Warning: can't find referenced class</b></a></dt>
147
148
 
148
 
<dd>If there are unresolved references to superclasses or interfaces, you most
149
 
    likely forgot to specify an essential library. All libraries that are
150
 
    referenced by your code should be specified, including the Java run-time
151
 
    library. For specifying libraries, use the <a
152
 
    href="usage.html#libraryjars"><code>-libraryjars</code></a> option.
 
149
<dd>If there are unresolved references to classes or interfaces, you most
 
150
    likely forgot to specify an essential library. For proper processing, all
 
151
    libraries that are referenced by your code must be specified, including
 
152
    the Java run-time library. For specifying libraries, use
 
153
    the <a href="usage.html#libraryjars"><code>-libraryjars</code></a> option.
153
154
    <p>
154
155
    If the class that is reported as missing is a non-public library class,
155
156
    you should specify the <a
156
157
    href="usage.html#dontskipnonpubliclibraryclasses"><code>-dontskipnonpubliclibraryclasses</code></a>
157
 
    option. A common example is the class
158
 
    <code>java.util.zip.ZipConstants</code>, which is used as an interface
159
 
    class in some public classes, even though it is only package visible (in
160
 
    this case, the warning could also be ignored, because the class is not a
161
 
    fundamental part of the class hierarchy).
 
158
    option. Common examples are the classes
 
159
    <code>javax.swing.TransferHandler$HasGetTransferHandler</code> and
 
160
    <code>java.util.zip.ZipConstants</code>, which are used as interfaces in
 
161
    some public classes, even though they are only package visible. This
 
162
    option is not set by default for reasons of efficiency. Setting it increases
 
163
    the processing time a bit, but it won't hurt the output in any way.
162
164
    <p>
163
165
    If you're missing a library and you're absolutely sure it isn't used
164
166
    anyway, you can try your luck with the <a
165
167
    href="usage.html#ignorewarnings"><code>-ignorewarnings</code></a> option,
166
168
    or even the <a href="usage.html#dontwarn"><code>-dontwarn</code></a>
167
 
    option.</dd>
 
169
    option. Only use these options if you really know what you're doing
 
170
    though.</dd>
168
171
 
169
172
<dt><a name="unresolvedclassmember"><b>Warning: can't find referenced field/method</b></a></dt>
170
173
 
455
458
    and/or <a
456
459
    href="usage.html#adaptresourcefilecontents"><code>-adaptresourcefilecontents</code></a>.
457
460
    <p>
458
 
    Note that directory entries in jar files aren't copied at all. If you
459
 
    refer to any directories from your code, you should add them
460
 
    manually.</dd>
 
461
    Furthermore, directory entries in jar files aren't copied, unless you
 
462
    specify the option <a
 
463
    href="usage.html#keepdirectories"><code>-keepdirectories</code></a>.</dd>
461
464
 
462
465
<dt><a name="invalidjarfile"><b>Invalid or corrupt jarfile</b></a></dt>
463
466
 
582
585
 
583
586
<hr>
584
587
<address>
585
 
Copyright &copy; 2002-2008
 
588
Copyright &copy; 2002-2009
586
589
<a href="http://www.graphics.cornell.edu/~eric/">Eric Lafortune</a>.
587
590
</address>
588
591
</body>