app_mode: Add runtime.onRestartRequired event.

chrome/common/extensions/api/runtime.json

Index: chrome/common/extensions/api/runtime.json
diff --git a/chrome/common/extensions/api/runtime.json b/chrome/common/extensions/api/runtime.json
index ad655e114396891b6f2bf5bd7a4161912e76bc15..d1b9c993dafc676dd490f61a479852899545c88b 100644
--- a/chrome/common/extensions/api/runtime.json
+++ b/chrome/common/extensions/api/runtime.json
@@ -352,9 +352,12 @@
         ]
       },
       {
+        // TODO(xiyuan): onBrowserUpdateAvailable is deprecated in favor of
+        // onRestartRequired. We should remove it when we are sure it is unused.
         "name": "onBrowserUpdateAvailable",
         "type": "function",
         "description": "Fired when a Chrome update is available, but isn't installed immediately because a browser restart is required.",
+        "nodoc": true,
         "parameters": []
       },
       {
@@ -408,10 +411,20 @@
           "optional": "true",
           "description": "Return true from the event listener if you wish to call <code>sendResponse</code> after the event listener returns."
         }
+      },
+      {
+        "name": "onRestartRequired",
+        "type": "function",
+        "description": "Fired when an app or the device that it runs on needs to be restarted. The app should close all its windows at its earliest convenient time to let the restart to happen. If the app does nothing, a restart will be enforced after a 24-hour grace period has passed. Currently, this event is only fired for Chrome OS kiosk apps.",
+        "parameters": [
+          {
+            "type": "string",
+            "name": "reason",
+            "description": "The reason that the event is being dispatched.",

[Matt Perry, 2013/06/21 22:43:32]

I think it's worth documenting what each enum means - especially "periodic",
which I don't understand.

[xiyuan, 2013/06/21 22:57:17]

Done.

+            "enum": ["app_update", "os_update", "periodic"]
+          }
+        ]
       }
-
-
-
     ]
   }
 ]