From 6a63aa3bfbcf30c2a01f35e3e6be651c5731dfc3 Mon Sep 17 00:00:00 2001
From: Suprabh Shukla <suprabh@google.com>
Date: Thu, 19 May 2022 15:31:05 -0700
Subject: [PATCH] Improve docs for SCHEDULE_EXACT_ALARM

Mentioning protection level and explicitly stating that the permission
is revocable.
Updated the hyperlink to a page with more comprehensive guidance.

Test: m offline-sdk-docs && \
  cd $ANDROID_BUILD_TOP/out/target/common/docs/offline-sdk/ && \
  python3 -m http.server 8000
Then manually inspect the contents of
http://localhost:8000/reference/android/Manifest.permission.html#SCHEDULE_EXACT_ALARM

Fixes: 205210647
Change-Id: Ide4c42ed22ee63df90c466f89331e5680cc39660
---
 core/res/AndroidManifest.xml | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/core/res/AndroidManifest.xml b/core/res/AndroidManifest.xml
index 8db5f9a1f51be..e52da0fd6787f 100644
--- a/core/res/AndroidManifest.xml
+++ b/core/res/AndroidManifest.xml
@@ -4495,10 +4495,10 @@
                 android:protectionLevel="signature|privileged"/>
 
     <!-- Allows applications to use exact alarm APIs.
-         <p>Exact alarms should only be used for user-facing features.
-         For more details, see <a
-         href="{@docRoot}about/versions/12/behavior-changes-12#exact-alarm-permission">
-         Exact alarm permission</a>.
+         <p>This is a special access permission that can be revoked by the system or the user.
+         It should only be used to enable <b>user-facing features</b> that require exact alarms.
+         For more details, please go through the associated
+          <a href="{@docRoot}training/scheduling/alarms#exact">developer docs</a>.
          <p>Apps need to target API {@link android.os.Build.VERSION_CODES#S} or above to be able to
          request this permission. Note that apps targeting lower API levels do not need this
          permission to use exact alarm APIs.
@@ -4509,6 +4509,7 @@
          {@link android.Manifest.permission#USE_EXACT_ALARM} once it targets API
          {@link android.os.Build.VERSION_CODES#TIRAMISU}. All apps using exact alarms for secondary
          features (which should still be user facing) should continue using this permission.
+         <p>Protection level: appop
      -->
     <permission android:name="android.permission.SCHEDULE_EXACT_ALARM"
         android:protectionLevel="normal|appop"/>