6655234: 4/4 j.l.i.: setNativeMethodPrefix does not document that prefix string can be null
authordcubed
Mon, 24 Mar 2008 17:16:10 -0700
changeset 283 f141a78d9f2b
parent 282 bca3e5a71df1
child 284 14672d061f7a
6655234: 4/4 j.l.i.: setNativeMethodPrefix does not document that prefix string can be null Summary: Clarify wording for 'prefix' parameter to setNativeMethodPrefix(). Reviewed-by: sspitsyn
jdk/src/share/classes/java/lang/instrument/Instrumentation.java
--- a/jdk/src/share/classes/java/lang/instrument/Instrumentation.java	Mon Mar 24 17:12:01 2008 -0700
+++ b/jdk/src/share/classes/java/lang/instrument/Instrumentation.java	Mon Mar 24 17:16:10 2008 -0700
@@ -636,7 +636,11 @@
      * @param   transformer
      *          The ClassFileTransformer which wraps using this prefix.
      * @param   prefix
-     *          The prefix which has been applied to wrapped native methods.
+     *          The prefix to apply to wrapped native methods when
+     *          retrying a failed native method resolution. If prefix
+     *          is either <code>null</code> or the empty string, then
+     *          failed native method resolutions are not retried for
+     *          this transformer.
      * @throws java.lang.NullPointerException if passed a <code>null</code> transformer.
      * @throws java.lang.UnsupportedOperationException if the current configuration of
      *           the JVM does not allow setting a native method prefix