Return an absolute URI for Platform.script.

sdk/lib/io/platform.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.
 
 part of dart.io;
 
 /**
  * The [Platform] class exposes details of the machine and operating
  * system.
  */
@@ skipping 62 matching lines @@
   /**
    * Returns the path of the executable used to run the script in this
    * isolate.
    *
    * If the execution environment does not support [executable] an empty
    * string is returned.
    */
   static String get executable => _Platform.executable;
 
   /**
-   * Returns the URI of the script being run in this
-   * isolate. If the URI is relative it is relative to the file URI of
-   * the working directory of the VM when it was started.
+   * Returns the absolute URI of the script being run in this
+   * isolate. If the script argument on the command line is relative,

[Anders Johnsen, 2013/11/01 10:13:51]

Newline*2 before `If`.

[Bill Hesse, 2013/11/01 12:49:46]

Done.

+   * it is resolved to an absolute URI before fetching the script, and
+   * this absolute URI is returned.
+   *
+   * This implies that a path including "link/.." in the script name

[Søren Gjesse, 2013/11/01 10:17:28]

Instead of trying to examplify here maybe just say something like URI resolving
is pure string operation and might not be the same as file system's path
resolution.

[Bill Hesse, 2013/11/01 12:49:46]

Done.  I think the specific case is worth including, because it is the most
important one.

+   * is resolved by dropping the link component, which may be different
+   * from the file system's path resolution behavior.
    *
    * If the executable environment does not support [script] an empty
    * URI is returned.
    */
   static Uri get script => _Platform.script;
 
   /**
    * Returns the flags passed to the executable used to run the script in this
    * isolate. These are the command-line flags between the executable name
    * and the script name. Each fetch of executableArguments returns a new
    * List, containing the flags passed to the executable.
    */
   static List<String> get executableArguments => _Platform.executableArguments;
 
   /**
    * Returns the value of the --package-root flag passed to the executable
    * used to run the script in this isolate.  This is the directory in which
    * Dart packages are looked up.
    *
    * If there is no --package-root flag, then the empty string is returned.
    */
   static String get packageRoot => _Platform.packageRoot;
 
   /**
    * Returns the version of the current Dart runtime.
    */
   static String get version => _version;
 }