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,
+   * it is resolved to an absolute URI before fetching the script, and
+   * this absolute URI is returned.
+   *
+   * URI resolution only does string manipulation on the script path, and this
+   * may be different from the file system's path resolution behavior. For
+   * example, a symbolic link immediately followed by '..' will not be
+   * looked up.
    *
    * If the executable environment does not support [script] an empty
-   * URI is returned.
+   * [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;
 }