Adding dev documentation for chrome.location

chrome/common/extensions/api/location.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.
 // TODO(vadimt): Consider reusing WebKit/Blink types, if this is possible.
 
-// The <code>chrome.location</code> API augments the events from the
-// <a href="http://dev.w3.org/geo/api/spec-source.html">HTML Geolocation API</a>
-// to be event page compatible.
+// Use the <code>chrome.location</code> API to retrieve the geographic location
+// of the host machine. This is a version of the <a

[Andy, 2013/07/30 20:26:14]

"This" --> "This API"

[vadimt, 2013/08/01 00:02:02]

Done.

+// href="http://dev.w3.org/geo/api/spec-source.html">HTML Geolocation API</a>
+// that is compatible with event pages.
 namespace location {
   // Coordinates part of the Location object.
   dictionary Coordinates {
     // The geographic latitude specified in degrees.
     double latitude;
 
     // The geographic longitude specified in degrees.
     double longitude;
 
     // The height of the position, specified in meters above the [WGS84]
@@ skipping 70 matching lines @@
   interface Events {
     // Fired when a location change is detected.
     // |location| : An object containing matching events and new location.
     static void onLocationUpdate(Location location);
 
     // Fired when detecting location in not possible.
     // |error| : Human-readable error description.
     static void onLocationError(DOMString error);
   };
 };