From 5ae13354773911f2c1567332a846020ff93390e3 Mon Sep 17 00:00:00 2001 From: Andrew Solovay Date: Fri, 6 Jun 2014 12:23:09 -0700 Subject: [PATCH] cherrypick from klp-docs docs: Corrected doc for getLaunchIntentForPackage(). Change-Id: I2eab0956eaedac71289e19a3618a3553908f8c38 Doc had inaccurately said that getLaunchIntentForPackage() throws an exception if the package name is not recognized; in fact, it returns null. Also cleaned up some style issues for that Javadoc item. Doc is staged to: http://asolovay.mtv:9655/reference/android/content/pm/PackageManager.html#getLaunchIntentForPackage(java.lang.String) Bug: 15022655 Original SHA1: I2eab0956eaedac71289e19a3618a3553908f8c38 Change-Id: Ief8dfaac248ba03779c6f13237aff9b26d362fd9 --- .../android/content/pm/PackageManager.java | 22 +++++++++---------- 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/core/java/android/content/pm/PackageManager.java b/core/java/android/content/pm/PackageManager.java index ff88dd7f83235..119ecb0a416c6 100644 --- a/core/java/android/content/pm/PackageManager.java +++ b/core/java/android/content/pm/PackageManager.java @@ -1460,21 +1460,19 @@ public abstract class PackageManager { public abstract String[] canonicalToCurrentPackageNames(String[] names); /** - * Return a "good" intent to launch a front-door activity in a package, - * for use for example to implement an "open" button when browsing through - * packages. The current implementation will look first for a main - * activity in the category {@link Intent#CATEGORY_INFO}, next for a - * main activity in the category {@link Intent#CATEGORY_LAUNCHER}, or return - * null if neither are found. - * - *

Throws {@link NameNotFoundException} if a package with the given - * name cannot be found on the system. + * Returns a "good" intent to launch a front-door activity in a package. + * This is used, for example, to implement an "open" button when browsing + * through packages. The current implementation looks first for a main + * activity in the category {@link Intent#CATEGORY_INFO}, and next for a + * main activity in the category {@link Intent#CATEGORY_LAUNCHER}. Returns + * null if neither are found. * * @param packageName The name of the package to inspect. * - * @return Returns either a fully-qualified Intent that can be used to - * launch the main activity in the package, or null if the package does - * not contain such an activity. + * @return A fully-qualified {@link Intent} that can be used to launch the + * main activity in the package. Returns null if the package + * does not contain such an activity, or if packageName is not + * recognized. */ public abstract Intent getLaunchIntentForPackage(String packageName);