Merge 200182 "Automatically detect inline-able doc in IDL files"

chrome/common/extensions/api/alarms.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.
 
 // TODO(mpcomplete): We need documentation before we can release this.
 
 namespace alarms {
   dictionary Alarm {
     // Name of this alarm.
     DOMString name;
@@ skipping 33 matching lines @@
   callback AlarmListCallback = void (Alarm[] alarms);
 
   interface Functions {
     // Creates an alarm.  Near the time(s) specified by <var>alarmInfo</var>,
     // the <code>onAlarm</code> event is fired. If there is another alarm with
     // the same name (or no name if none is specified), it will be cancelled and
     // replaced by this alarm.
     //
     // In order to reduce the load on the user's machine, Chrome limits alarms
     // to at most once every 1 minute but may delay them an arbitrary amount
-    // more.  That is, setting <code>$ref:[alarms.AlarmCreateInfo.delayInMinutes
-    // delayInMinutes]</code> or
-    // <code>$ref:[alarms.AlarmCreateInfo.periodInMinutes
-    // periodInMinutes]</code> to less than <code>1</code> will not be honored
-    // and will cause a warning.  <code>$ref:[alarms.AlarmCreateInfo.when
-    // when]</code> can be set to less than 1 minute after "now" without
-    // warning but won't actually cause the alarm to fire for at least 1 minute.
+    // more.  That is, setting <code>delayInMinutes</code> or
+    // <code>periodInMinutes</code> to less than <code>1</code> will not be
+    // honored and will cause a warning.  <code>when</code> can be set to less
+    // than 1 minute after "now" without warning but won't actually cause the
+    // alarm to fire for at least 1 minute.
     //
     // To help you debug your app or extension, when you've loaded it unpacked,
     // there's no limit to how often the alarm can fire.
     //
     // |name|: Optional name to identify this alarm. Defaults to the empty
     // string.
     //
     // |alarmInfo|: Describes when the alarm should fire.  The initial time must
     // be specified by either <var>when</var> or <var>delayInMinutes</var> (but
     // not both).  If <var>periodInMinutes</var> is set, the alarm will repeat
@@ skipping 17 matching lines @@
     // Clears all alarms.
     static void clearAll();
   };
 
   interface Events {
     // Fired when an alarm has elapsed. Useful for event pages.
     // |alarm|: The alarm that has elapsed.
     static void onAlarm(Alarm alarm);
   };
 };