Improve doc.
Change-Id: I841b04e1e455b6236fb8b65b965f2fc25c4461f0
diff --git a/core/java/android/app/Notification.java b/core/java/android/app/Notification.java
index 5525ce3..63ad92a 100644
--- a/core/java/android/app/Notification.java
+++ b/core/java/android/app/Notification.java
@@ -109,9 +109,14 @@
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
+ * <strong>immediate</strong>attention, 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;
