Make chrome.alarms API accept non-integers and too-short delays.

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 31 matching lines @@
 
   callback AlarmCallback = void (Alarm alarm);
   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.
     //
-    // Note that granularity is not guaranteed: times are more of a hint to the
-    // browser. For performance reasons, alarms may be delayed an arbitrary
-    // amount of time before firing.
+    // In order to reduce the load on the user's machine, Chrome limits alarms
+    // to at most once every 5 minutes 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>5</code> will not be honored
+    // and cause a warning.  <code>$ref:[alarms.AlarmCreateInfo.when

[Yoyo Zhou, 2013/01/09 00:38:00]

will cause

[Jeffrey Yasskin, 2013/01/09 01:04:45]

Done.

+    // when]</code> can be set to less than 5 minutes after "now" without
+    // warning but won't actually cause the alarm to run for at least 5 minutes.

[Yoyo Zhou, 2013/01/09 00:38:00]

s/run/fire/

[Jeffrey Yasskin, 2013/01/09 01:04:45]

Done.

+    //
+    // 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
     // every <var>periodInMinutes</var> minutes after the initial event.  If
     // neither <var>when</var> or <var>delayInMinutes</var> is set for a
     // repeating alarm, <var>periodInMinutes</var> is used as the default for
@@ skipping 14 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);
   };
 };