Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit e1b56701 authored by Trevor Johns's avatar Trevor Johns Committed by android-build-merger
Browse files

Merge changes from topic \'merge_docs_nyc-dev\' into nyc-dev am: 59c9a93f 

am: 254f1b8a

* commit '254f1b8a':
  Remove links to createAndInitializeUser() and createUser()
  Resolve merge conflicts of a5060ee8 to nyc-dev

Change-Id: I32a3081af9ca5533785c90b7239ffd5b5e69d5bf
parents 4450987a 254f1b8a

core/java/android/app/Activity.java

+5 −23
Original line number Original line Diff line number Diff line
@@ -200,7 +200,7 @@ import java.util.List; 
 *

 *

 * <p>An activity has essentially four states:</p>

 * <p>An activity has essentially four states:</p>

 * <ul>

 * <ul>

 *     <li> If an activity in the foreground of the screen (at the top of

 *     <li> If an activity is in the foreground of the screen (at the top of

 *         the stack),

 *         the stack),

 *         it is <em>active</em> or  <em>running</em>. </li>

 *         it is <em>active</em> or  <em>running</em>. </li>

 *     <li>If an activity has lost focus but is still visible (that is, a new non-full-sized

 *     <li>If an activity has lost focus but is still visible (that is, a new non-full-sized
@@ -674,7 +674,7 @@ import java.util.List; 
 * independently of the activity lifecycle itself.  An example may be a camera

 * independently of the activity lifecycle itself.  An example may be a camera

 * application that allows you to upload a picture to a web site.  The upload

 * application that allows you to upload a picture to a web site.  The upload

 * may take a long time, and the application should allow the user to leave

 * may take a long time, and the application should allow the user to leave

 * the application will it is executing.  To accomplish this, your Activity

 * the application while it is executing.  To accomplish this, your Activity

 * should start a {@link Service} in which the upload takes place.  This allows

 * should start a {@link Service} in which the upload takes place.  This allows

 * the system to properly prioritize your process (considering it to be more

 * the system to properly prioritize your process (considering it to be more

 * important than other non-visible applications) for the duration of the

 * important than other non-visible applications) for the duration of the
@@ -4077,28 +4077,10 @@ public class Activity extends ContextThemeWrapper 
     * result callbacks including {@link #onRequestPermissionsResult(int, String[], int[])}.

     * result callbacks including {@link #onRequestPermissionsResult(int, String[], int[])}.

     * </p>

     * </p>

     * <p>

     * <p>

     * A sample permissions request looks like this:

     * The <a href="http://developer.android.com/samples/RuntimePermissions/index.html">

     * RuntimePermissions</a> sample app demonstrates how to use this method to

     * request permissions at run time.

     * </p>

     * </p>

     * <code><pre><p>

     * private void showContacts() {

     *     if (checkSelfPermission(Manifest.permission.READ_CONTACTS)

     *             != PackageManager.PERMISSION_GRANTED) {

     *         requestPermissions(new String[]{Manifest.permission.READ_CONTACTS},

     *                 PERMISSIONS_REQUEST_READ_CONTACTS);

     *     } else {

     *         doShowContacts();

     *     }

     * }

     *

     * {@literal @}Override

     * public void onRequestPermissionsResult(int requestCode, String[] permissions,

     *         int[] grantResults) {

     *     if (requestCode == PERMISSIONS_REQUEST_READ_CONTACTS

     *             && grantResults[0] == PackageManager.PERMISSION_GRANTED) {

     *         showContacts();

     *     }

     * }

     * </code></pre></p>

     *

     *

     * @param permissions The requested permissions. Must me non-null and not empty.

     * @param permissions The requested permissions. Must me non-null and not empty.

     * @param requestCode Application specific request code to match with a result

     * @param requestCode Application specific request code to match with a result

core/java/android/appwidget/package.html

+1 −1
Original line number Original line Diff line number Diff line
@@ -16,7 +16,7 @@ provide a {@link android.content.BroadcastReceiver} that receives the {@link 
android.appwidget.AppWidgetManager#ACTION_APPWIDGET_UPDATE} intent

android.appwidget.AppWidgetManager#ACTION_APPWIDGET_UPDATE} intent

and provide some metadata about the app widget.  Android provides the

and provide some metadata about the app widget.  Android provides the

{@link android.appwidget.AppWidgetProvider} class, which extends {@link

{@link android.appwidget.AppWidgetProvider} class, which extends {@link

android.content.BroadcastReceiver}, as a convenience class to define the app widget behavrio and aid

android.content.BroadcastReceiver}, as a convenience class to define the app widget behavior and aid

in handling the broadcasts.</p>

in handling the broadcasts.</p>





<p>App widget hosts are the containers in which widgets can be placed.  Most of the look and feel

<p>App widget hosts are the containers in which widgets can be placed.  Most of the look and feel

core/java/android/content/Intent.java

+16 −15
Original line number Original line Diff line number Diff line
@@ -115,7 +115,7 @@ import static android.content.ContentProvider.maybeAddUserId; 
 *   </li>

 *   </li>

 *   <li> <p><b>{@link #ACTION_VIEW} <i>tel:123</i></b> -- Display

 *   <li> <p><b>{@link #ACTION_VIEW} <i>tel:123</i></b> -- Display

 *     the phone dialer with the given number filled in.  Note how the

 *     the phone dialer with the given number filled in.  Note how the

 *     VIEW action does what what is considered the most reasonable thing for

 *     VIEW action does what is considered the most reasonable thing for

 *     a particular URI.</p>

 *     a particular URI.</p>

 *   </li>

 *   </li>

 *   <li> <p><b>{@link #ACTION_DIAL} <i>tel:123</i></b> -- Display

 *   <li> <p><b>{@link #ACTION_DIAL} <i>tel:123</i></b> -- Display
@@ -186,7 +186,7 @@ import static android.content.ContentProvider.maybeAddUserId; 
 *

 *

 * <p>There are a variety of standard Intent action and category constants

 * <p>There are a variety of standard Intent action and category constants

 * defined in the Intent class, but applications can also define their own.

 * defined in the Intent class, but applications can also define their own.

 * These strings use java style scoping, to ensure they are unique -- for

 * These strings use Java-style scoping, to ensure they are unique -- for

 * example, the standard {@link #ACTION_VIEW} is called

 * example, the standard {@link #ACTION_VIEW} is called

 * "android.intent.action.VIEW".</p>

 * "android.intent.action.VIEW".</p>

 *

 *
@@ -339,7 +339,7 @@ import static android.content.ContentProvider.maybeAddUserId; 
 *     &lt;action android:name="{@link #ACTION_EDIT android.intent.action.EDIT}" /&gt;

 *     &lt;action android:name="{@link #ACTION_EDIT android.intent.action.EDIT}" /&gt;

 *     &lt;action android:name="{@link #ACTION_PICK android.intent.action.PICK}" /&gt;

 *     &lt;action android:name="{@link #ACTION_PICK android.intent.action.PICK}" /&gt;

 *     &lt;category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" /&gt;

 *     &lt;category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" /&gt;

 *     &lt;data mimeType:name="vnd.android.cursor.dir/<i>vnd.google.note</i>" /&gt;

 *     &lt;data android:mimeType="vnd.android.cursor.dir/<i>vnd.google.note</i>" /&gt;

 * &lt;/intent-filter&gt;</pre>

 * &lt;/intent-filter&gt;</pre>

 * <p>This declares the things that the activity can do on a directory of

 * <p>This declares the things that the activity can do on a directory of

 * notes.  The type being supported is given with the &lt;type&gt; tag, where

 * notes.  The type being supported is given with the &lt;type&gt; tag, where
@@ -358,7 +358,7 @@ import static android.content.ContentProvider.maybeAddUserId; 
 *     &lt;category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" /&gt;

 *     &lt;category android:name="{@link #CATEGORY_DEFAULT android.intent.category.DEFAULT}" /&gt;

 *     &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;

 *     &lt;data android:mimeType="vnd.android.cursor.item/<i>vnd.google.note</i>" /&gt;

 * &lt;/intent-filter&gt;</pre>

 * &lt;/intent-filter&gt;</pre>

 * <p>This filter describes the ability return to the caller a note selected by

 * <p>This filter describes the ability to return to the caller a note selected by

 * the user without needing to know where it came from.  The data type

 * the user without needing to know where it came from.  The data type

 * <code>vnd.android.cursor.item/vnd.google.note</code> is a URI from which

 * <code>vnd.android.cursor.item/vnd.google.note</code> is a URI from which

 * a Cursor of exactly one (<code>vnd.android.cursor.item</code>) item can

 * a Cursor of exactly one (<code>vnd.android.cursor.item</code>) item can
@@ -1324,14 +1324,14 @@ public class Intent implements Parcelable, Cloneable { 
            "android.intent.extra.ASSIST_INPUT_DEVICE_ID";

            "android.intent.extra.ASSIST_INPUT_DEVICE_ID";





    /**

    /**

     * Activity Action: List all available applications

     * Activity Action: List all available applications.

     * <p>Input: Nothing.

     * <p>Input: Nothing.

     * <p>Output: nothing.

     * <p>Output: nothing.

     */

     */

    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)

    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)

    public static final String ACTION_ALL_APPS = "android.intent.action.ALL_APPS";

    public static final String ACTION_ALL_APPS = "android.intent.action.ALL_APPS";

    /**

    /**

     * Activity Action: Show settings for choosing wallpaper

     * Activity Action: Show settings for choosing wallpaper.

     * <p>Input: Nothing.

     * <p>Input: Nothing.

     * <p>Output: Nothing.

     * <p>Output: Nothing.

     */

     */
@@ -2070,7 +2070,7 @@ public class Intent implements Parcelable, Cloneable { 
    /**

    /**

     * Broadcast Action: An existing application package has been removed from

     * Broadcast Action: An existing application package has been removed from

     * the device.  The data contains the name of the package.  The package

     * the device.  The data contains the name of the package.  The package

     * that is being installed does <em>not</em> receive this Intent.

     * that is being removed does <em>not</em> receive this Intent.

     * <ul>

     * <ul>

     * <li> {@link #EXTRA_UID} containing the integer uid previously assigned

     * <li> {@link #EXTRA_UID} containing the integer uid previously assigned

     * to the package.

     * to the package.
@@ -2104,9 +2104,9 @@ public class Intent implements Parcelable, Cloneable { 
    public static final String ACTION_PACKAGE_FULLY_REMOVED

    public static final String ACTION_PACKAGE_FULLY_REMOVED

            = "android.intent.action.PACKAGE_FULLY_REMOVED";

            = "android.intent.action.PACKAGE_FULLY_REMOVED";

    /**

    /**

     * Broadcast Action: An existing application package has been changed (e.g.

     * Broadcast Action: An existing application package has been changed (for

     * a component has been enabled or disabled).  The data contains the name of

     * example, a component has been enabled or disabled).  The data contains

     * the package.

     * the name of the package.

     * <ul>

     * <ul>

     * <li> {@link #EXTRA_UID} containing the integer uid assigned to the package.

     * <li> {@link #EXTRA_UID} containing the integer uid assigned to the package.

     * <li> {@link #EXTRA_CHANGED_COMPONENT_NAME_LIST} containing the class name

     * <li> {@link #EXTRA_CHANGED_COMPONENT_NAME_LIST} containing the class name
@@ -2202,9 +2202,9 @@ public class Intent implements Parcelable, Cloneable { 
    public static final String ACTION_UID_REMOVED = "android.intent.action.UID_REMOVED";

    public static final String ACTION_UID_REMOVED = "android.intent.action.UID_REMOVED";





    /**

    /**

     * Broadcast Action: Sent to the installer package of an application

     * Broadcast Action: Sent to the installer package of an application when

     * when that application is first launched (that is the first time it

     * that application is first launched (that is the first time it is moved

     * is moved out of the stopped state).  The data contains the name of the package.

     * out of the stopped state).  The data contains the name of the package.

     *

     *

     * <p class="note">This is a protected intent that can only be sent

     * <p class="note">This is a protected intent that can only be sent

     * by the system.

     * by the system.
@@ -2232,8 +2232,9 @@ public class Intent implements Parcelable, Cloneable { 
    public static final String ACTION_PACKAGE_VERIFIED = "android.intent.action.PACKAGE_VERIFIED";

    public static final String ACTION_PACKAGE_VERIFIED = "android.intent.action.PACKAGE_VERIFIED";





    /**

    /**

     * Broadcast Action: Sent to the system intent filter verifier when an intent filter

     * Broadcast Action: Sent to the system intent filter verifier when an

     * needs to be verified. The data contains the filter data hosts to be verified against.

     * intent filter needs to be verified. The data contains the filter data

     * hosts to be verified against.

     * <p class="note">

     * <p class="note">

     * This is a protected intent that can only be sent by the system.

     * This is a protected intent that can only be sent by the system.

     * </p>

     * </p>

core/java/android/content/pm/PackageManager.java

+1 −1
Original line number Original line Diff line number Diff line
@@ -1736,7 +1736,7 @@ public abstract class PackageManager { 




    /**

    /**

     * Feature for {@link #getSystemAvailableFeatures} and

     * Feature for {@link #getSystemAvailableFeatures} and

     * {@link #hasSystemFeature}: The heart rate sensor on this device is an Electrocargiogram.

     * {@link #hasSystemFeature}: The heart rate sensor on this device is an Electrocardiogram.

     */

     */

    @SdkConstant(SdkConstantType.FEATURE)

    @SdkConstant(SdkConstantType.FEATURE)

    public static final String FEATURE_SENSOR_HEART_RATE_ECG =

    public static final String FEATURE_SENSOR_HEART_RATE_ECG =

core/java/android/hardware/input/InputManager.java

+1 −1
Original line number Original line Diff line number Diff line
@@ -121,7 +121,7 @@ public final class InputManager { 
     * </p><p>

     * </p><p>

     * The <code>android:name</code> attribute specifies an identifier by which

     * The <code>android:name</code> attribute specifies an identifier by which

     * the keyboard layout will be known in the package.

     * the keyboard layout will be known in the package.

     * The <code>android:label</code> attributes specifies a human-readable descriptive

     * The <code>android:label</code> attribute specifies a human-readable descriptive

     * label to describe the keyboard layout in the user interface, such as "English (US)".

     * label to describe the keyboard layout in the user interface, such as "English (US)".

     * The <code>android:keyboardLayout</code> attribute refers to a

     * The <code>android:keyboardLayout</code> attribute refers to a

     * <a href="http://source.android.com/tech/input/key-character-map-files.html">

     * <a href="http://source.android.com/tech/input/key-character-map-files.html">