From ddb768648ffea9614b96eaaaac4b10f294d63569 Mon Sep 17 00:00:00 2001
From: Robert Horvath <robhor@google.com>
Date: Tue, 2 Feb 2021 13:55:57 +0100
Subject: [PATCH] Document behaviour of "quiescent" reboot reason

On Android TV, adding ",quiescent" to the reboot reason performs a
quiescent boot, during which the screen stays off.

Bug: 178802099
Test: Still compiles
Change-Id: Ib593ba863a718f869bbd04ff24593d0e0a384d99
---
 core/java/android/os/PowerManager.java | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/core/java/android/os/PowerManager.java b/core/java/android/os/PowerManager.java
index 059e932a9da91..eb4ed35645363 100644
--- a/core/java/android/os/PowerManager.java
+++ b/core/java/android/os/PowerManager.java
@@ -1629,6 +1629,12 @@ public final class PowerManager {
      * <p>
      * Requires the {@link android.Manifest.permission#REBOOT} permission.
      * </p>
+     * <p>
+     * If the {@code reason} string contains ",quiescent", then the screen stays off during reboot
+     * and is not turned on again until the user triggers the device to wake up (for example,
+     * by pressing the power key).
+     * This behavior applies to Android TV devices launched on Android 11 (API level 30) or higher.
+     * </p>
      *
      * @param reason code to pass to the kernel (e.g., "recovery") to
      *               request special boot modes, or null.