Update notification.idl following the Mac OS X changes

chrome/common/extensions/api/notifications.idl

 // Copyright (c) 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // Use the <code>chrome.notifications</code> API to create rich notifications
 // using templates and show these notifications to users in the system tray.
 namespace notifications {
   [noinline_doc] enum TemplateType {
     // icon, title, message, expandedMessage, up to two buttons
     basic,
 
     // icon, title, message, expandedMessage, image, up to two buttons
+    [deprecated="The image is not visible for Mac OS X users."]
     image,
 
-    // icon, title, message, items, up to two buttons
+    // icon, title, message, items, up to two buttons. Users on Mac OS X only
+    // see the first item.
     list,
 
     // icon, title, message, progress, up to two buttons
     progress
   };
 
   enum PermissionLevel {
     // User has elected to show notifications from the app or extension.
     // This is the default at install time.
     granted,
@@ skipping 11 matching lines @@
   };
 
   [nodoc] dictionary NotificationBitmap {
     long width;
     long height;
     ArrayBuffer? data;
   };
 
   dictionary NotificationButton {
     DOMString title;
+    [deprecated="Button icons not visible for Mac OS X users."]
     DOMString? iconUrl;
     [nodoc] NotificationBitmap? iconBitmap;
   };
 
   dictionary NotificationOptions {
     // Which type of notification to display.
     // <em>Required for $(ref:notifications.create)</em> method.
     TemplateType? type;
 
     // A URL to the sender's avatar, app icon, or a thumbnail for image
     // notifications.
     //
     // URLs can be a data URL, a blob URL, or a URL relative to a resource
     // within this extension's .crx file
     // <em>Required for $(ref:notifications.create)</em> method.
     DOMString? iconUrl;
     [nodoc] NotificationBitmap? iconBitmap;
 
     // A URL to the app icon mask. URLs have the same restrictions as
     // $(ref:notifications.NotificationOptions.iconUrl iconUrl).
-    // 
+    //
     // The app icon mask should be in alpha channel, as only the alpha channel
     // of the image will be considered.
+    [deprecated="The app icon mask is not visible for Mac OS X users."]
     DOMString? appIconMaskUrl;
     [nodoc] NotificationBitmap? appIconMaskBitmap;
 
     // Title of the notification (e.g. sender name for email).
     // <em>Required for $(ref:notifications.create)</em> method.
     DOMString? title;
 
     // Main notification content.
     // <em>Required for $(ref:notifications.create)</em> method.
     DOMString? message;
@@ skipping 11 matching lines @@
     // epoch (e.g. <code>Date.now() + n</code>).
     double? eventTime;
 
     // Text and icons for up to two notification action buttons.
     NotificationButton[]? buttons;
 
     // Secondary notification content.
     [nodoc] DOMString? expandedMessage;
 
     // A URL to the image thumbnail for image-type notifications.
-    // URLs have the same restrictions as 
+    // URLs have the same restrictions as
     // $(ref:notifications.NotificationOptions.iconUrl iconUrl).
+    [deprecated="The image is not visible for Mac OS X users."]
     DOMString? imageUrl;
     [nodoc] NotificationBitmap? imageBitmap;
 
-    // Items for multi-item notifications.
+    // Items for multi-item notifications. Users on Mac OS X only see the first
+    // item.
     NotificationItem[]? items;
 
     // Current progress ranges from 0 to 100.
     long? progress;
 
     // Whether to show UI indicating that the app will visibly respond to
     // clicks on the body of a notification.
     boolean? isClickable;
 
     // Indicates that the notification should remain visible on screen until the
@@ skipping 70 matching lines @@
 
     // The user changes the permission level.  As of Chrome 47, only ChromeOS
     // has UI that dispatches this event.
     static void onPermissionLevelChanged(PermissionLevel level);
 
     // The user clicked on a link for the app's notification settings.  As of
     // Chrome 47, only ChromeOS has UI that dispatches this event.
     static void onShowSettings();
   };
 };