Fix Directory, File and Link constructor text.

sdk/lib/io/link.dart

 // Copyright (c) 2013, 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;
 
 /**
  * [Link] objects are references to filesystem links.
  *
  */
 abstract class Link extends FileSystemEntity {
   /**
    * Creates a Link object.
    */
   factory Link(String path) => new _Link(path);
 
   /**
-   * Create a Lint object from a URI.
+   * Creates a [Link] object.
    *
-   * If [uri] cannot reference a link this throws [UnsupportedError].
+   * If [path] is a relative path, it will be interpreted relative to the
+   * current working directory (see [Directory.current]), when used.
+   *
+   * If [path] is an absolute path, it will be immune to changes to the
+   * current working directory.
    */
   factory Link.fromUri(Uri uri) => new Link(uri.toFilePath());
 
   /**
    * Creates a symbolic link. Returns a [:Future<Link>:] that completes with
    * the link when it has been created. If the link exists,
    * the future will complete with an error.
    *
    * If [recursive] is false, the default, the link is created
    * only if all directories in its path exist.
@@ skipping 261 matching lines @@
         return new ArgumentError();
       case _OSERROR_RESPONSE:
         var err = new OSError(response[_OSERROR_RESPONSE_MESSAGE],
                               response[_OSERROR_RESPONSE_ERROR_CODE]);
         return new FileSystemException(message, path, err);
       default:
         return new Exception("Unknown error");
     }
   }
 }