Fixing many link syntaxes in doc comments

sdk/lib/io/directory.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;
 
 /**
  * A reference to a directory (or _folder_) on the file system.
  *
  * A Directory instance is an object holding a [path] on which operations can
@@ skipping 82 matching lines @@
  *       });
  *     }
  *
  *
  * In addition to exists, the [stat], [rename], and
  * other methods, return Futures.
  *
  * ## Other resources
  *
  * * [Dart by Example](https://www.dartlang.org/dart-by-example/#files-directories-and-symlinks)
- * provides additional task-oriented code samples that show how to use
- * various API from the Directory class and the related [File] class.
+ *   provides additional task-oriented code samples that show how to use
+ *   various API from the Directory class and the related [File] class.
  *
- * * [I/O for Command-Line Apps](https://www.dartlang.org/docs/dart-up-and-running/contents/ch03.html#ch03-dartio---file-and-socket-io-for-command-line-apps)
- * a section from _A Tour of the Dart Libraries_
- * covers files and directories.
+ * * [I/O for Command-Line
+ *   Apps](https://www.dartlang.org/docs/dart-up-and-running/ch03.html#dartio---io-for-command-line-apps)
+ *   a section from _A Tour of the Dart Libraries_ covers files and directories.
  *
  * * [Write Command-Line Apps](https://www.dartlang.org/docs/tutorials/cmdline/),
- * a tutorial about writing command-line apps, includes information
- * about files and directories.
+ *   a tutorial about writing command-line apps, includes information about
+ *   files and directories.
  */
 abstract class Directory implements FileSystemEntity {
   /**
    * Gets the path of this directory.
    */
   final String path;
 
   /**
    * Creates a [Directory] object.
    *
@@ skipping 181 matching lines @@
    * directories, files, and links.
    */
   List<FileSystemEntity> listSync({bool recursive: false,
                                    bool followLinks: true});
 
   /**
    * Returns a human readable string for this Directory instance.
    */
   String toString();
 }