From 55b2d11cd30b0088206750cf38cca94b5a229e35 Mon Sep 17 00:00:00 2001
From: Robert Sesek <rsesek@google.com>
Date: Tue, 17 May 2016 18:53:13 -0400
Subject: [PATCH] Add clarifying documentation to
 Context.BIND_EXTERNAL_SERVICE.

Bug: 28775488
Change-Id: Ic0473d3664671f0ac5df8412f61ca8c1d029887f
---
 core/java/android/content/Context.java | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/core/java/android/content/Context.java b/core/java/android/content/Context.java
index 8f5ddf818bf4f..a43d06ed5ae0d 100644
--- a/core/java/android/content/Context.java
+++ b/core/java/android/content/Context.java
@@ -342,6 +342,14 @@ public abstract class Context {
      * {@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;