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.
 
 /**
  * Generates the complete set of corelib reference documentation.
  */
 #library('apidoc');
 
 #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;
+
+  var outputDir = 'docs';
+
+  // Use the output directory if provided.
+  if (args.length > 1) {
+    print('Usage: apidoc [--out=<output directory>]');
+    return;
+  } else if (args.length == 1) {
+    final arg = args[0];
+    if (arg.startsWith('--out=')) {
+      outputDir = arg.substring('--out='.length);
+    } else {
+      print('Unknown option: $arg');
+      return;
+    }
+  }
+
+  doc.cleanOutputDirectory(outputDir);
+
+  // 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('../../frog', ['', '', '--libdir=../../frog/lib'], files);
   initializeWorld(files);
 
   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('dart:io');
 
   print('Generating docs...');
-  final apidoc = new Apidoc(mdn);
+  final apidoc = new Apidoc(mdn, outputDir);
   apidoc.document('html');
 }
 
 class Apidoc extends doc.Dartdoc {
   /** Big ball of JSON containing the scraped MDN documentation. */
   final Map mdn;
 
   /**
    * The URL to the page on MDN that content was pulled from for the current
    * type being documented. Will be `null` if the type doesn't use any MDN
    * content.
    */
   String mdnUrl;
 
-  Apidoc(this.mdn) {
+  Apidoc(this.mdn, String outputDir) {
+    this.outputDir = outputDir;
+
     mainTitle = 'Dart API Reference';
     mainUrl = 'http://dartlang.org';
 
     final note    = 'http://code.google.com/policies.html#restrictions';
     final cca     = 'http://creativecommons.org/licenses/by/3.0/';
     final bsd     = 'http://code.google.com/google_bsd_license.html';
     final tos     = 'http://www.dartlang.org/tos.html';
     final privacy = 'http://www.google.com/intl/en/privacy/privacy-policy.html';
 
     footerText =
@@ skipping 316 matching lines @@
       return
           '''
           <p class="correspond">This corresponds to $domTypesText in the
           ${a("dom.html", "dart:dom")} library.</p>
           ''';
     }
 
     return '';
   }
 }