Clarify some Binder docs regarding things that are thread-local.

Change-Id: I433c9c2f4593866b2e9846893676b93a670817d4

1 files changed, 9 insertions, 8 deletions

diff --git a/core/java/android/os/Binder.java b/core/java/android/os/Binder.java
index df10c6a..c9df567 100644
--- a/core/java/android/os/Binder.java
+++ b/core/java/android/os/Binder.java
@@ -73,30 +73,31 @@ public class Binder implements IBinder {
     public static final native int getCallingUid();
     
     /**
-     * Reset the identity of the incoming IPC to the local process.  This can
+     * Reset the identity of the incoming IPC on the current thread.  This can
      * be useful if, while handling an incoming call, you will be calling
      * on interfaces of other objects that may be local to your process and
      * need to do permission checks on the calls coming into them (so they
      * will check the permission of your own local process, and not whatever
      * process originally called you).
-     * 
+     *
      * @return Returns an opaque token that can be used to restore the
      * original calling identity by passing it to
      * {@link #restoreCallingIdentity(long)}.
-     * 
+     *
      * @see #getCallingPid()
      * @see #getCallingUid()
      * @see #restoreCallingIdentity(long)
      */
     public static final native long clearCallingIdentity();
-    
+
     /**
-     * Restore the identity of the incoming IPC back to a previously identity
-     * that was returned by {@link #clearCallingIdentity}.
-     * 
+     * Restore the identity of the incoming IPC on the current thread
+     * back to a previously identity that was returned by {@link
+     * #clearCallingIdentity}.
+     *
      * @param token The opaque token that was previously returned by
      * {@link #clearCallingIdentity}.
-     * 
+     *
      * @see #clearCallingIdentity
      */
     public static final native void restoreCallingIdentity(long token);