fix doc comments in dart:io and collection types

sdk/lib/io/sync_socket.dart

 // Copyright (c) 2017, 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 low-level class for communicating synchronously over a TCP socket.
  *
  * Warning: [RawSynchronousSocket] should probably only be used to connect to
@@ skipping 50 matching lines @@
    * sent by the socket. [bytes] specifies the maximum number of bytes to
    * be read. Returns the list of bytes read, which could be less than the
    * value specified by [bytes].
    */
   List<int> readSync(int bytes);
 
   /**
    * Shutdown a socket in the provided direction.
    *
    * Calling shutdown will never throw an exception and calling it several times
-   * is supported. If both [RECEIVE] and [SEND] directions are closed, the
-   * socket is closed completely, the same as if [closeSync] has been called.
+   * is supported. If both [SocketDirection.RECEIVE] and [SocketDirection.SEND]
+   * directions are closed, the socket is closed completely, the same as if
+   * [closeSync] has been called.
    */
   void shutdown(SocketDirection direction);
 
   /**
    * Writes data from a specified range in a [List<int>] to the socket.
    *
    * Writes into the socket from a [List<int>]. If [start] is present, the bytes
    * will be written to the socket starting from index [start]. If [start] is
    * not present, the bytes will be written starting from index 0. If [end] is
    * present, the [end] - [start] bytes will be written into the socket starting
@@ skipping 16 matching lines @@
   /**
    * The [InternetAddress] used to connect this socket.
    */
   InternetAddress get address;
 
   /**
    * The remote [InternetAddress] connected to by this socket.
    */
   InternetAddress get remoteAddress;
 }