Dynamically generate a heading for Extension Docs API pages

chrome/common/extensions/api/file_system.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.
 
+// Use the <code>chrome.fileSystem</code> module to create, read, navigate,
+// and write to a sandboxed section of the user's local file system. With this
+// API, packaged apps can read and write to a user-seleced location. For
+// example, a text editor app can use the API to read and write local documents.
 namespace fileSystem {
   dictionary AcceptOption {
     // This is the optional text description for this option. If not present,
     // a description will be automatically generated; typically containing an
     // expanded list of valid extensions (e.g. "text/html" may expand to
     // "*.html, *.htm").
     DOMString? description;
 
     // Mime-types to accept, e.g. "image/jpeg" or "audio/*". One of mimeTypes or
     // extensions must contain at least one valid element.
@@ skipping 69 matching lines @@
     // Returns whether a file entry for the given id can be restored, i.e.
     // whether restoreEntry would succeed with this id now.
     static void isRestorable(DOMString id, IsRestorableCallback callback);
 
     // Returns an id that can be passed to restoreEntry to regain access to a
     // given file entry. Only the 500 most recently used entries are retained,
     // where calls to retainEntry and restoreEntry count as use.
     static DOMString retainEntry([instanceOf=FileEntry] object fileEntry);
   };
 };