Add template for chrome.hid documentation.

chrome/common/extensions/api/hid.idl

 // Copyright 2014 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.hid</code> API to interact with connected HID devices.
 // This API provides access to HID operations from within the context of an app.
 // Using this API, apps can function as drivers for hardware devices.
 namespace hid {
-
-  // HID usage pair.
-  // |usage_page|: HID usage page.
-  // |usage|: HID usage.
+  // HID usage pair. Each enumerated device interface exposes an array of
+  // these objects. Values correspond to those defined by the
+  // <a href="http://www.usb.org/developers/devclass_docs/HID1_11.pdf>
+  // HID device class specification</a>.
+  // |usage_page|: HID usage page identifier.
+  // |usage|: Page-defined usage identifier.
   dictionary HidUsageAndPage {
     long usage_page;
     long usage;
   };
 
   // Returned by <code>getDevices</code> functions to describes a connected HID
   // device. Use <code>connect</code> to connect to any of the returned devices.
   // |deviceId|: Device opaque ID.
   // |vendorId|: Vendor ID.
   // |productId|: Product ID.
@@ skipping 90 matching lines @@
     // |connectionId|: The connection to read Input report from.
     // |reportId|: The report ID to use, or <code>0</code> if none.
     // |data|: The report data.
     // |callback|: The callback to invoke once the write is finished.
     static void sendFeatureReport(long connectionId,
                                   long reportId,
                                   ArrayBuffer data,
                                   SendCallback callback);
   };
 };