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.
 
-// 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.
 
 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 72 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);
   };
 };