From a0527f207bf4af313e9f4fa9c39afe1bbee51e16 Mon Sep 17 00:00:00 2001
From: Brad Fitzpatrick <bradfitz@android.com>
Date: Thu, 25 Mar 2010 20:40:34 -0700
Subject: [PATCH] Clarify some Binder docs regarding things that are
 thread-local.

Change-Id: I433c9c2f4593866b2e9846893676b93a670817d4
---
 core/java/android/os/Binder.java | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/core/java/android/os/Binder.java b/core/java/android/os/Binder.java
index df10c6aef904d..c9df5671ddf2f 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);