Merge from oc-preview-docs-release: docs: Added note that INSTALL_SHORTCUT is implicit broadcast as of O.

The INSTALL_SHORTCUT broadcast is now a private, implicit broadcast,
so app developers should pin a shortcut themselves using the methods
in the ShortcutManager class on Android O and higher. Updated
manifest permission doc accordingly.

Test: make ds-docs
Bug: 36442658
Change-Id: I1777dfde691089485dc4e6b7cb8a9de0ee527298
Original-Change-Id: I0ef5595e2f08efbab6c28af5fa2f6b6c2295424c
diff --git a/core/res/AndroidManifest.xml b/core/res/AndroidManifest.xml
index 794d4f8..93d55a7 100644
--- a/core/res/AndroidManifest.xml
+++ b/core/res/AndroidManifest.xml
@@ -1965,6 +1965,11 @@
     <eat-comment />
 
     <!-- Allows an application to install a shortcut in Launcher.
+         <p>In Android O (API level 26) and higher, the <code>INSTALL_SHORTCUT</code> broadcast no
+         longer has any effect on your app because it's a private, implicit
+         broadcast. Instead, you should create an app shortcut by using the
+         {@link android.content.pm.ShortcutManager#requestPinShortcut requestPinShortcut()}
+         method from the {@link android.content.pm.ShortcutManager} class.
          <p>Protection level: normal
     -->
     <permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"