Add deprecation message in chrome.pushMessaging API

chrome/common/extensions/api/push_messaging.idl

Index: chrome/common/extensions/api/push_messaging.idl
diff --git a/chrome/common/extensions/api/push_messaging.idl b/chrome/common/extensions/api/push_messaging.idl
index 0f6917542248db1a813fd7b91b7a668a333b924d..9012d5de12dfa843a708ba7fa08d0803a37169d0 100644
--- a/chrome/common/extensions/api/push_messaging.idl
+++ b/chrome/common/extensions/api/push_messaging.idl
@@ -2,9 +2,11 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// Use <code>chrome.pushMessaging</code> to enable apps and extensions to
-// receive message data sent through
+// The <code>chrome.pushMessaging</code> API is currently deprecated since

[not at google - send to devlin, 2014/08/21 00:36:33]

No "currently".

[fgorski, 2014/08/22 18:23:38]

Done.

+// Chrome 38, and will no longer be supported in Chrome 40.
+// Switch to <code>$(ref:gcm)</code> to take advantage of
 // <a href="cloudMessaging.html">Google Cloud Messaging</a>.
+[deprecated="Use $(ref:gcm) API"]
 namespace pushMessaging {
 
   dictionary Message {
@@ -31,6 +33,7 @@ namespace pushMessaging {
     // to trigger push messages back to the app or extension.
     // If the interactive flag is set, we will ask the user to log in
     // when they are not already logged in.
+    [deprecated="Use $(ref:gcm) API"]

[not at google - send to devlin, 2014/08/21 00:36:33]

Nit: seems like it should read either "the gcm API" or just "gcm", so "Use
$(ref:gcm chrome.gcm)" or "$Use the $(ref:gcm chrome.gcm API)".

[fgorski, 2014/08/22 18:23:39]

Done.

     static void getChannelId(optional boolean interactive,
                              ChannelIdCallback callback);
   };
@@ -38,6 +41,7 @@ namespace pushMessaging {
   interface Events {
     // Fired when a push message has been received.
     // |message| : The details associated with the message.
+    [deprecated="Use $(ref:gcm)"]
     static void onMessage(Message message);
   };
 };