Dartdoc and apidoc updated to use Path.

lib/dartdoc/mirrors/mirrors.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.
 
 #library('mirrors');
 
+#import('dart:io');
 #import('dart:uri');
 #import('dart2js_mirror.dart');
 
 /**
  * [Compilation] encapsulates the compilation of a program.
  */
 class Compilation {
   /**
    * Creates a new compilation which has [script] as its entry point.
    */
-  factory Compilation(String script,
-                      String libraryRoot,
-                      [String packageRoot,
+  factory Compilation(Path script,
+                      Path libraryRoot,
+                      [Path packageRoot,
                        List<String> opts = const <String>[]]) {
     return new Dart2JsCompilation(script, libraryRoot, packageRoot, opts);
   }
-  factory Compilation.library(List<String> libraries,
-                              String libraryRoot,
-                              [String packageRoot,
+
+  /**
+   * Creates a new compilation which consists of a set of libraries, but which
+   * has no entry point. This compilation cannot generate output but can only
+   * be used for static inspection of the source code.
+   */
+  factory Compilation.library(List<Path> libraries,
+                              Path libraryRoot,
+                              [Path packageRoot,
                                List<String> opts = const []]) {
     return new Dart2JsCompilation.library(libraries, libraryRoot,
                                           packageRoot, opts);
   }
 
   /**
    * Returns the mirror system for this compilation.
    */
   abstract MirrorSystem mirrors();
+
+  /**
+   * Returns a future for the compiled JavaScript code.
+   */
+  abstract Future<String> compileToJavaScript();

[Bill Hesse, 2012/07/17 13:42:13]

Why is this a Future?  I don't see anywhere where this is not actually an
immediate Future?

[Johnni Winther, 2012/07/19 08:37:07]

The future is used to follow a suggestion for the Compilation interface by ahe
and rnystrom. In time, dart2js should be able to do asynchronous compilation, I
think.

 }
 
 /**
  * The main interface for the whole mirror system.
  */
 interface MirrorSystem {
   /**
    * Returns an unmodifiable map of all libraries in this mirror system.
    */
   Map<Object, LibraryMirror> libraries();
@@ skipping 397 matching lines @@
   /**
    * Returns the URI where the source originated.
    */
   Uri uri();
 
   /**
    * Returns the text of this source.
    */
   String text();
 }