Integrate VM IO libraries and search box into apidoc.

utils/apidoc/apidoc.dart

 // Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 /**
  * Generates the complete set of corelib reference documentation.
  */
 #library('apidoc');
 
 #import('dart:json');
@@ skipping 12 matching lines @@
 
   print('Parsing MDN data...');
   final mdn = JSON.parse(files.readAll('mdn/database.json'));
 
   print('Cross-referencing dart:dom and dart:html...');
   HtmlDiff.initialize();
   _diff = new HtmlDiff();
   _diff.run();
   world.reset();
 
+  // TODO(rnystrom): Cram in the the IO libraries. This is hackish right now.
+  // We should probably move corelib stuff completely out of dartdoc and have it
+  // all here.
+  world.getOrAddLibrary('io_libs.dart');
+
   print('Generating docs...');
   final apidoc = new Apidoc(mdn);
   apidoc.document('html');
 }
 
 class Apidoc extends doc.Dartdoc {
   /** Big ball of JSON containing the scraped MDN documentation. */
   final Map mdn;
 
   /**
@@ skipping 15 matching lines @@
 
     footerText =
         '''
         <p>Except as otherwise <a href="$note">noted</a>, the content of this
         page is licensed under the <a href="$cca">Creative Commons Attribution
         3.0 License</a>, and code samples are licensed under the
         <a href="$bsd">BSD License</a>.</p>
         <p><a href="$tos">Terms of Service</a> |
         <a href="$privacy">Privacy Policy</a></p>
         ''';
+
+    searchEngineId = '011220921317074318178:i4mscbaxtru';
+    searchResultsUrl = 'http://www.dartlang.org/search.html';
   }
 
   void writeHeadContents(String title) {
     super.writeHeadContents(title);
 
     // Include the apidoc-specific CSS.
     // TODO(rnystrom): Use our CSS pre-processor to combine these.
     writeln(
         '''
         <link rel="stylesheet" type="text/css"
@@ skipping 14 matching lines @@
             ga.type = "text/javascript"; ga.async = true;
             ga.src = ("https:" == document.location.protocol ?
               "https://ssl" : "http://www") + ".google-analytics.com/ga.js";
             var s = document.getElementsByTagName("script")[0];
             s.parentNode.insertBefore(ga, s);
           })();
         </script>
         ''');
   }
 
+  void docIndexLibrary(Library library) {
+    // TODO(rnystrom): Hackish. The IO libraries reference this but we don't
+    // want it in the docs.

[nweiz, 2012/01/31 23:35:33]

I dunno if this is even that hackish. It makes sense to me that a
library-specific documentor would have some library-specific logic like this.

It might be nicer to have this in some sort of in-code annotation, I suppose.

[Bob Nystrom, 2012/02/01 00:35:29]

Yeah, it's kind of hairy because if stuff in the io libs actually referenced
types or members in "dart:nativewrappers" then we would still be linking to
those things even though that library doesn't exist in the navigation.

+    if (library.name == 'dart:nativewrappers') return;
+    super.docIndexLibrary(library);
+  }
+
+  void docLibraryNavigationJson(Library library, Map libraries) {
+    // TODO(rnystrom): Hackish. The IO libraries reference this but we don't
+    // want it in the docs.
+    if (library.name == 'dart:nativewrappers') return;
+    super.docLibraryNavigationJson(library, libraries);
+  }
+
+  void docLibrary(Library library) {
+    // TODO(rnystrom): Hackish. The IO libraries reference this but we don't
+    // want it in the docs.
+    if (library.name == 'dart:nativewrappers') return;
+    super.docLibrary(library);
+  }
+
   String getTypeComment(Type type) {
     return _mergeDocs(
         includeMdnTypeComment(type),
         super.getTypeComment(type),
         getTypeDoc(type));
   }
 
   String getMethodComment(MethodMember method) {
     // TODO(rnystrom): Disabling cross-linking between individual members.
     // Now that we include MDN content for most members, it doesn't add much
@@ skipping 239 matching lines @@
       return
           '''
           <p class="correspond">This corresponds to $domTypesText in the
           ${a("dom.html", "dart:dom")} library.</p>
           ''';
     }
 
     return '';
   }
 }