Generate API docs during build.

utils/apidoc/apidoc.dart

 // Copyright (c) 2012, 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.
 
 /**
  * This generates the reference documentation for the core libraries that come
  * with dart. It is built on top of dartdoc, which is a general-purpose library
  * for generating docs from any Dart code. This library extends that to include
  * additional information and styling specific to our standard library.
  *
  * Usage:
  *
  *     $ dart apidoc.dart [--out=<output directory>]
  */
 #library('apidoc');
 
+#import('dart:io');
 #import('dart:json');
 #import('html_diff.dart');
 #import('../../frog/lang.dart');
 #import('../../frog/file_system_vm.dart');
 #import('../../frog/file_system.dart');
 #import('../../lib/dartdoc/dartdoc.dart', prefix: 'doc');
 
 HtmlDiff _diff;
 
 final GET_PREFIX = 'get:';
 
 void main() {
   final args = new Options().arguments;
 
   int mode = doc.MODE_STATIC;
-  var outputDir = 'docs';
+  String outputDir = 'docs';
 
-  // Use the output directory if provided.
-
-  for (int i = 0; i < args.length - 1; i++) {
+  // Parse the command-line arguments.
+  for (int i = 0; i < args.length; i++) {
     final arg = args[i];
 
     switch (arg) {
       case '--mode=static':
         mode = doc.MODE_STATIC;
         break;
 
       case '--mode=live-nav':
         mode = doc.MODE_LIVE_NAV;
         break;
@@ skipping 29 matching lines @@
   doc.copyFiles('${doc.scriptDir}/../../lib/dartdoc/static', outputDir);
 
   // The apidoc-specific static content.
   doc.copyFiles('${doc.scriptDir}/static', outputDir);
 
   var files = new VMFileSystem();
   parseOptions(frogPath, ['', '', '--libdir=$frogPath/lib'], files);
   initializeWorld(files);
 
   print('Parsing MDN data...');
-  final mdn = JSON.parse(files.readAll('mdn/database.json'));
+  final mdnFile = new File('${doc.scriptDir}/mdn/database.json');
+  final mdn = JSON.parse(mdnFile.readAsTextSync());
 
   print('Cross-referencing dart:dom and dart:html...');
   HtmlDiff.initialize();
   _diff = new HtmlDiff();
   _diff.run();
   world.reset();
 
   // Add all of the core libraries.
   world.getOrAddLibrary('dart:core');
   world.getOrAddLibrary('dart:coreimpl');
@@ skipping 383 matching lines @@
       return
           '''
           <p class="correspond">This corresponds to $domTypesText in the
           ${a("dom.html", "dart:dom")} library.</p>
           ''';
     }
 
     return '';
   }
 }