Merge "Add clarifying documentation to Context.BIND_EXTERNAL_SERVICE." into nyc-dev
am: f45bc095c6
* commit 'f45bc095c6cef916f5f801fb320b3413f0fc099a':
Add clarifying documentation to Context.BIND_EXTERNAL_SERVICE.
Change-Id: I5306ff5f4e9abe6161616873e752cf4d54ed6408
diff --git a/core/java/android/content/Context.java b/core/java/android/content/Context.java
index caf0d00..9eb9423 100644
--- a/core/java/android/content/Context.java
+++ b/core/java/android/content/Context.java
@@ -342,6 +342,14 @@
* {@link android.R.attr#isolatedProcess isolated},
* {@link android.R.attr#externalService external} service. This binds the service into the
* calling application's package, rather than the package in which the service is declared.
+ * <p>
+ * When using this flag, the code for the service being bound will execute under the calling
+ * application's package name and user ID. Because the service must be an isolated process,
+ * it will not have direct access to the application's data, though.
+ *
+ * The purpose of this flag is to allow applications to provide services that are attributed
+ * to the app using the service, rather than the application providing the service.
+ * </p>
*/
public static final int BIND_EXTERNAL_SERVICE = 0x80000000;