Merge "Fix some API comments for archive APIs." into main
diff --git a/core/java/android/content/pm/PackageInstaller.java b/core/java/android/content/pm/PackageInstaller.java
index 457fd63..51f3d8e 100644
--- a/core/java/android/content/pm/PackageInstaller.java
+++ b/core/java/android/content/pm/PackageInstaller.java
@@ -379,7 +379,8 @@
/**
* If true, the requestor of the unarchival has specified that the app should be unarchived
- * for all users.
+ * for all users. Sent as part of the {@link android.content.Intent#ACTION_UNARCHIVE_PACKAGE}
+ * intent.
*/
@FlaggedApi(Flags.FLAG_ARCHIVING)
public static final String EXTRA_UNARCHIVE_ALL_USERS =
@@ -396,6 +397,9 @@
* with an intent for a corresponding follow-up action (e.g. storage clearing dialog) or a
* failure dialog.
*
+ * <p> Used as part of {@link #requestUnarchive} to return the status of the unarchival through
+ * the {@link IntentSender}.
+ *
* @see #requestUnarchive
*/
@FlaggedApi(Flags.FLAG_ARCHIVING)
@@ -704,7 +708,8 @@
/**
* The installer responsible for the unarchival is disabled.
*
- * <p> Should only be used by the system.
+ * <p> The system will return this status if appropriate. Installers do not need to verify for
+ * this error.
*/
@FlaggedApi(Flags.FLAG_ARCHIVING)
public static final int UNARCHIVAL_ERROR_INSTALLER_DISABLED = 4;
@@ -712,7 +717,8 @@
/**
* The installer responsible for the unarchival has been uninstalled
*
- * <p> Should only be used by the system.
+ * <p> The system will return this status if appropriate. Installers do not need to verify for
+ * this error.
*/
@FlaggedApi(Flags.FLAG_ARCHIVING)
public static final int UNARCHIVAL_ERROR_INSTALLER_UNINSTALLED = 5;