diff options
Diffstat (limited to 'docs/manual/limitations.html')
| -rw-r--r-- | docs/manual/limitations.html | 57 |
1 files changed, 31 insertions, 26 deletions
diff --git a/docs/manual/limitations.html b/docs/manual/limitations.html index cfe0ff5..6b69410 100644 --- a/docs/manual/limitations.html +++ b/docs/manual/limitations.html @@ -1,10 +1,21 @@ -<!doctype html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=iso-8859-1"> <meta http-equiv="content-style-type" content="text/css"> <link rel="stylesheet" type="text/css" href="style.css"> <title>ProGuard Limitations</title> +<script type="text/javascript" language="JavaScript"> +<!-- +if (window.self==window.top) + window.top.location.replace("../index.html#"+window.location.pathname+window.location.hash); +else { + var hash="#"+window.location.pathname.replace(window.top.location.pathname.replace("index.html", ""), ""); + if (window.top.location.hash!=hash) + window.top.location.hash=hash; +} +//--> +</script> </head> <body> @@ -13,16 +24,7 @@ When using ProGuard, you should be aware of a few technical issues, all of which are easily avoided or resolved: <p> -<ul> - -<li>For efficiency, ProGuard always ignores any <b>private or package visible - library classes</b> while reading library jars. If any of them are - extended by public library classes, and then extended again by input - classes, ProGuard will complain it can't find them. In that case, you'll - have to use the <code>-dontskipnonpubliclibraryclasses</code> option, and - maybe even the <code>-dontskipnonpubliclibraryclassmembers</code> option. - The graphical user interface has checkboxes for these settings. - <p> +<ul class="spacious"> <li>For best results, ProGuard's optimization algorithms assume that the processed code never <b>intentionally throws NullPointerExceptions</b> or @@ -33,32 +35,35 @@ which are easily avoided or resolved: <code>myObject</code> might be null, causing a NullPointerException. In some way this is a good thing: optimized code may throw fewer exceptions. Should this entire assumption be false, you'll have to switch off - optimization using the <code>-dontoptimize</code> option. - <p> + optimization using the <code>-dontoptimize</code> option.</li> + +<li>ProGuard's optimization algorithms currently also assume that the + processed code never creates <b>busy-waiting loops</b> without at least + testing on a volatile field. Again, it may remove such loops. Should this + assumption be false, you'll have to switch off optimization using + the <code>-dontoptimize</code> option.</li> <li>If an input jar and a library jar contain classes in the <b>same package</b>, the obfuscated output jar may contain class names that overlap with class names in the library jar. This is most likely if the library jar has been obfuscated before, as it will then probably contain classes named 'a', 'b', etc. Packages should therefore never be split - across input jars and library jars. - <p> + across input jars and library jars.</li> -<li>When obfuscating, ProGuard will write out class files named - "<code>a.class</code>", "<code>b.class</code>", etc. If there is a large - numbers of classes in the same package, it may also write out - <b>"<code>aux.class</code>"</b>. Windows doesn't allow creating files with - this reserved name (among a few other names), so it's generally better to - write the output to a jar, in order to avoid such problems. - <p> +<li>When obfuscating, ProGuard writes out class files named + "<code>a.class</code>", "<code>b.class</code>", etc. If a package contains + a large number of classes, ProGuard may also write out + <b>"<code>aux.class</code>"</b>. Inconveniently, Windows refuses to create + files with this reserved name (among a few other names). It's generally + better to write the output to a jar, in order to avoid such problems.</li> </ul> -<p> -<hr> +<hr /> +<noscript><div><a target="_top" href="../index.html" class="button">Show menu</a></div></noscript> <address> -Copyright © 2002-2009 -<a href="http://www.graphics.cornell.edu/~eric/">Eric Lafortune</a>. +Copyright © 2002-2013 +<a target="other" href="http://www.lafortune.eu/">Eric Lafortune</a>. </address> </body> </html> |