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:';
@@ skipping 11 matching lines @@
     final arg = args[0];
     if (arg.startsWith('--out=')) {
       outputDir = arg.substring('--out='.length);
     } else {
       print('Unknown option: $arg');
       return;
     }
   }
 
   final frogPath = joinPaths(doc.scriptDir, '../../frog/');
+  final libDir = joinPaths(frogPath, 'lib');
+  final compilerPath = joinPaths(frogPath, 'minfrog');

[dgrove, 2012/03/30 17:46:31]

minfrog is going away. why not just run frog out of the SDK? That will get you
on the right path for running dart2js later.

[Bob Nystrom, 2012/03/30 18:01:40]

There will be enormous changes to dartdoc and apidoc when frog goes away.
Running frog from the SDK would mean (I'm guessing) figuring out where you build
directory is, which is kind of hairy. Can this wait until a later patch? I want
to get this in as soon as possible.

[dgrove, 2012/03/30 18:16:25]

yes. this can wait, given the reality that there will be big changes soon.

On 2012/03/30 18:01:40, Bob Nystrom wrote:

 
   doc.cleanOutputDirectory(outputDir);
 
   // Compile the client-side code to JS.
-  // TODO(bob): Right path.
-  doc.compileScript(frogPath,
-      '${doc.scriptDir}/../../lib/dartdoc/client-live-nav.dart',
-      '${outputDir}/client-live-nav.js');
+  doc.compileScript(compilerPath, libDir,
+      joinPaths(doc.scriptDir, '/../../lib/dartdoc/client-live-nav.dart'),
+      joinPaths(outputDir, 'client-live-nav.js'));
 
   // TODO(rnystrom): Use platform-specific path separator.
   // The basic dartdoc-provided static content.
   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 354 matching lines @@
       return
           '''
           <p class="correspond">This corresponds to $domTypesText in the
           ${a("dom.html", "dart:dom")} library.</p>
           ''';
     }
 
     return '';
   }
 }