From 170bae7d832e0fd68e1ee9d96893b97e1dd98c52 Mon Sep 17 00:00:00 2001 From: Dianne Hackborn Date: Fri, 3 Sep 2010 15:14:28 -0700 Subject: [PATCH] Improve doc. Change-Id: I841b04e1e455b6236fb8b65b965f2fc25c4461f0 --- core/java/android/app/Notification.java | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/core/java/android/app/Notification.java b/core/java/android/app/Notification.java index 5525ce3d85af3..63ad92a3b41ea 100644 --- a/core/java/android/app/Notification.java +++ b/core/java/android/app/Notification.java @@ -109,9 +109,14 @@ public class Notification implements Parcelable public PendingIntent deleteIntent; /** - * An intent to launch instead of posting the notification to the status bar. Only for use with - * extremely high-priority notifications demanding the user's attention, such as an incoming + * An intent to launch instead of posting the notification to the status bar. + * Only for use with extremely high-priority notifications demanding the user's + * immediateattention, such as an incoming phone call or + * alarm clock that the user has explicitly set to a particular time. * call (handled in the core Android Phone app with a full-screen Activity). + * If this facility is used for something else, please give the user an option + * to turn it off and use a normal notification, as this can be extremely + * disruptive. */ public PendingIntent fullScreenIntent;