Merge "Add clarifying documentation to Context.BIND_EXTERNAL_SERVICE." into nyc-dev am: f45bc095c6

am: a83b4cfc74

* commit 'a83b4cfc74716e3945d40dc3f7c6ae94d1a158e4':
  Add clarifying documentation to Context.BIND_EXTERNAL_SERVICE.

Change-Id: I331ee57d710539b3988ff71b96e2f6155da75c9a

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;