Dynamically generate a heading for Extension Docs API pages

chrome/common/extensions/api/socket.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.socket</code> module to send and receive data over the
+// network using TCP and UDP connections.
+
 namespace socket {
   enum SocketType {
     tcp,
     udp
   };
 
   // The socket options.
   dictionary CreateOptions {
   };
 
@@ skipping 231 matching lines @@
     // |callback| : Called when the state is available.
     static void getInfo(long socketId,
                         GetInfoCallback callback);
 
     // Retrieves information about local adapters on this system.
     // |callback| : Called when local adapter information is available.
     static void getNetworkList(GetNetworkCallback callback);
   };
 
 };