Dynamically generate a heading for Extension Docs API pages

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.

[not at google - send to devlin, 2013/04/30 18:34:19]

erm, this comment seems wrong, given we released it...

[epeterson, 2013/05/13 02:38:10]

Done. I noticed this earlier, but removing someone else's TODO just didn't feel
right..

 
-// TODO(mpcomplete): We need documentation before we can release this.
+// Use the <code>chrome.alarms</code> module to schedule code to run
+// periodically or at a specified time in the future.
 

[not at google - send to devlin, 2013/04/30 18:34:19]

no extra newline. maybe the other IDL files have that, you should delete them.

[epeterson, 2013/05/13 02:38:10]

Done. (For the other IDL files, as well)

 namespace alarms {
   dictionary Alarm {
     // Name of this alarm.
     DOMString name;
 
     // Time at which this alarm was scheduled to fire, in milliseconds past the
     // epoch (e.g. <code>Date.now() + n</code>).  For performance reasons, the
     // alarm may have been delayed an arbitrary amount beyond this.
     double scheduledTime;
 
@@ skipping 71 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);
   };
 };