Implementation of the "Redirect URLs to Packaged Apps" feature.

chrome/common/extensions/api/app_runtime.idl

 // Copyright (c) 2012 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.
 
 namespace app.runtime {
 
   [inline_doc] dictionary LaunchItem {
     // FileEntry for the file.
     [instanceOf=FileEntry] object entry;
 
     // The MIME type of the file.
     DOMString type;
   };
 
   // Optional data for the launch.
   [inline_doc] dictionary LaunchData {
-    // The id of the file handler that the app is being invoked with.
+    // The ID of the file or URL handler that the app is being invoked with.
+    // Handler IDs are the top-level keys in the 'file_handlers' and/or
+    // 'url_handlers' dictionaries in the manifest.

[not at google - send to devlin, 2013/08/29 17:35:56]

for all instance of 'foo' change to <code>foo</code>.

even better: link to where they are documented with <code><a
href="file_handlers.html">file_handlers</a></code> etc. you will need to add
docs for url handlers eventually, so remember to link to those.

[sergeygs, 2013/08/30 00:39:44]

Done (the first option). I think docs for url_handlers will not have their own
separate html, just like most manifest keys, including file_handlers. Most of
them just have a section in manifest.html. I'll see if I can add references to
there.

     DOMString? id;
 
+    // The file entries for onLaunched corresponding to a file handler
+    // from the 'file_handlers' key in the manifest.
     LaunchItem[]? items;
+
+    // The URL for onLaunched corresponding to a URL handler from the
+    // 'url_handlers' key in the manifest.
+    DOMString? url;
+
+    // The referrer URL for onLaunched corresponding to a URL handler
+    // from the 'url_handlers' key in the manifest.
+    DOMString? referrerUrl;
   };
 
   interface Events {
     // Fired when an app is launched from the launcher.
     static void onLaunched(optional LaunchData launchData);
 
     // Fired at Chrome startup to apps that were running when Chrome last shut
     // down.
     static void onRestarted();
   };
 };