From 12b1297938cf2f67f48f8d5f8920b0c09cb6a2f9 Mon Sep 17 00:00:00 2001
From: Yeabkal Wubshit <yeabkal@google.com>
Date: Sun, 3 Jul 2022 06:26:03 +0000
Subject: [PATCH] Fix NotificationChannel#setVibrationPattern API Documentation

NotificationManagerService has a logic to fallback to a default vibration pattern if the channel has vibration enabled. Accordingly, this CL fixes the message in the setVibrationPattern API Javadoc.

Change-Id: I909819eb98e5fe3ab8b80f25db7437860ac560ca
---
 core/java/android/app/NotificationChannel.java | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/core/java/android/app/NotificationChannel.java b/core/java/android/app/NotificationChannel.java
index c9cc1a179102a..0e89b25eb37dc 100644
--- a/core/java/android/app/NotificationChannel.java
+++ b/core/java/android/app/NotificationChannel.java
@@ -564,8 +564,10 @@ public final class NotificationChannel implements Parcelable {
 
     /**
      * Sets the vibration pattern for notifications posted to this channel. If the provided
-     * pattern is valid (non-null, non-empty), will {@link #enableVibration(boolean)} enable
-     * vibration} as well. Otherwise, vibration will be disabled.
+     * pattern is valid (non-null, non-empty), will enable vibration on this channel
+     * (equivalent to calling {@link #enableVibration(boolean)} with {@code true}).
+     * Otherwise, vibration will be disabled unless {@link #enableVibration(boolean)} is
+     * used with {@code true}, in which case the default vibration will be used.
      *
      * Only modifiable before the channel is submitted to
      * {@link NotificationManager#createNotificationChannel(NotificationChannel)}.