Merge "Refine documentation of getNativeTid() function"

1 files changed, 7 insertions, 3 deletions

diff --git a/ojluni/src/main/java/java/lang/Thread.java b/ojluni/src/main/java/java/lang/Thread.java
index bc46b82e5e..699a1ac539 100644
--- a/ojluni/src/main/java/java/lang/Thread.java
+++ b/ojluni/src/main/java/java/lang/Thread.java
@@ -2341,9 +2341,13 @@ class Thread implements Runnable {
     // Android-added: Android specific nativeGetStatus() method.
     private native int nativeGetStatus(boolean hasBeenStarted);
 
-    // Android-added: Customize behavior of Thread.setPriority(). http://b/139521784
-    // Note: this function returns the tid of native thread, which is different than
-    // the managed tid of Thread.
+    // BEGIN Android-added: Customize behavior of Thread.setPriority(). http://b/139521784
+    /**
+     * Returns the thread ID of the underlying native thread -- which is different from
+     * the {@link #getId() managed thread ID} -- or 0 if the native thread is not
+     * started or has stopped.
+     */
     @FastNative
     private native int getNativeTid();
+    // END Android-added: Customize behavior of Thread.setPriority(). http://b/139521784
 }