API Review: clearUserDataOnFailedRestore manifest flag

Document the bahavior chane for the old flag (clearUserData) starting
from API 29. The API level check is already in place: https://cs.corp.google.com/android/frameworks/base/services/backup/java/com/android/server/backup/UserBackupManagerService.java?q=UserBackupManagerService.java&sq=package:android&g=0&l=1521

Bug: 127465240
Test: N/A
Change-Id: Ic9c497857427a72e89e5e1a0937b3502d8623f21

diff --git a/core/res/res/values/attrs_manifest.xml b/core/res/res/values/attrs_manifest.xml
index dbea13e..fe2c665 100644 (file)
--- a/core/res/res/values/attrs_manifest.xml
+++ b/core/res/res/values/attrs_manifest.xml
@@ -118,8 +118,11 @@
     <attr name="manageSpaceActivity" format="string" />
 
     <!-- Option to let applications specify that user data can/cannot be
-         cleared by the user in Settings. This flag is turned on by default.
-         <em>This attribute is usable only by applications
+         cleared. This flag is turned on by default.
+         <p>Starting from API level 29 this flag only controls if the user can
+         clear app data from Settings. To control clearing the data after a
+         failed restore use allowClearUserDataOnFailedRestore flag.
+         <p><em>This attribute is usable only by applications
          included in the system image. Third-party apps cannot use it.</em> -->
     <attr name="allowClearUserData" format="boolean" />