Big merge from experimental to bleeding edge.

sdk/lib/_internal/dartdoc/bin/dartdoc.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.
 
 /**
  * To generate docs for a library, run this script with the path to an
  * entrypoint .dart file, like:
  *
  *     $ dart dartdoc.dart foo.dart
  *
  * This will create a "docs" directory with the docs for your libraries. To
  * create these beautiful docs, dartdoc parses your library and every library
  * it imports (recursively). From each library, it parses all classes and
  * members, finds the associated doc comments and builds crosslinked docs from
  * them.
  */
 library dartdoc;
 
 import 'dart:io';
+import 'dart:async';
 
 // TODO(rnystrom): Use "package:" URL (#4968).
 import '../lib/dartdoc.dart';
 import '../../../../../pkg/args/lib/args.dart';
 
 /**
  * Run this from the `lib/_internal/dartdoc` directory.
  */
 main() {
   // Need this because ArgParser.getUsage doesn't show command invocation.
@@ skipping 189 matching lines @@
   Future compiled = compileScript(dartdoc.mode, dartdoc.outputDir, libPath);
   Future filesCopied = copyDirectory(scriptDir.append('../static'),
                                      dartdoc.outputDir);
 
   Futures.wait([compiled, filesCopied]).then((_) {
     dartdoc.cleanup();
     print('Documented ${dartdoc.totalLibraries} libraries, '
           '${dartdoc.totalTypes} types, and ${dartdoc.totalMembers} members.');
   });
 }