Document inapplicable cases for @NeverCompile
This change mentions native methods and abstract methods as cases for
which @NeverCompile will not be useful.
Bug: 197753440
Test: N/A (addition to javadoc)
Change-Id: I65c79705d6484055cf4c1fc4397af521086333a6
diff --git a/dalvik/src/main/java/dalvik/annotation/optimization/NeverCompile.java b/dalvik/src/main/java/dalvik/annotation/optimization/NeverCompile.java
index 61fe622..b5e72fc 100644
--- a/dalvik/src/main/java/dalvik/annotation/optimization/NeverCompile.java
+++ b/dalvik/src/main/java/dalvik/annotation/optimization/NeverCompile.java
@@ -37,6 +37,12 @@
* </p>
*
* <p>
+ * This annotation will have no effect when applied to native methods, as JNI stubs will still be
+ * compiled. In addition, it will not stop overriding methods from being compiled, so applying this
+ * annotation to abstract methods will not do anything.
+ * </p>
+ *
+ * <p>
* The <code>dumpPackageLPr</code> method in com.android.server.pm can be used as a concrete
* example. This is a debug method used to dump all of the information about a device's installed
* packages. When it is compiled, it is included in services.odex. Annotating this method with
