use proper notation for true, false, and null in doc comments

sdk/lib/io/socket.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;
 
 
 /**
  * [InternetAddressType] is the type an [InternetAddress]. Currently,
  * IP version 4 (IPv4) and IP version 6 (IPv6) are supported.
@@ skipping 341 matching lines @@
   }
 }
 
 /**
  * The [RawSocket] is a low-level interface to a socket, exposing the raw
  * events signaled by the system. It's a [Stream] of [RawSocketEvent]s.
  */
 abstract class RawSocket implements Stream<RawSocketEvent> {
   /**
    * Set or get, if the [RawSocket] should listen for [RawSocketEvent.READ]
-   * events. Default is [true].
+   * events. Default is [:true:].
    */
   bool readEventsEnabled;
 
   /**
    * Set or get, if the [RawSocket] should listen for [RawSocketEvent.WRITE]
-   * events. Default is [true].
+   * events. Default is [:true:].
    * This is a one-shot listener, and writeEventsEnabled must be set
    * to true again to receive another write event.
    */
   bool writeEventsEnabled;
 
   /**
    * Creates a new socket connection to the host and port and returns a [Future]
    * that will complete with either a [RawSocket] once connected or an error
    * if the host-lookup or connection failed.
    *
    * [host] can either be a [String] or an [InternetAddress]. If [host] is a
    * [String], [connect] will perform a [InternetAddress.lookup] and use
    * the first value in the list.
    */
   external static Future<RawSocket> connect(host, int port);
 
   /**
    * Returns the number of received and non-read bytes in the socket that
    * can be read.
    */
   int available();
 
   /**
    * Read up to [len] bytes from the socket. This function is
    * non-blocking and will only return data if data is available. The
    * number of bytes read can be less then [len] if fewer bytes are
-   * available for immediate reading. If no data is available [null]
+   * available for immediate reading. If no data is available [:null:]
    * is returned.
    */
   List<int> read([int len]);
 
   /**
    * Writes up to [count] bytes of the buffer from [offset] buffer offset to
    * the socket. The number of successfully written bytes is returned. This
    * function is non-blocking and will only write data if buffer space is
    * available in the socket.
    *
@@ skipping 37 matching lines @@
    * throw an exception and calling it several times is supported. Calling
    * shutdown with either [SocketDirection.BOTH] or [SocketDirection.RECEIVE]
    * can result in a [RawSocketEvent.READ_CLOSED] event.
    */
   void shutdown(SocketDirection direction);
 
   /**
    * Use [setOption] to customize the [RawSocket]. See [SocketOption] for
    * available options.
    *
-   * Returns [true] if the option was set successfully, false otherwise.
+   * Returns [:true:] if the option was set successfully, false otherwise.
    */
   bool setOption(SocketOption option, bool enabled);
 }
 
 /**
  * A high-level class for communicating over a TCP socket.
  *
  * The [Socket] exposes both a [Stream] and a [IOSink] interface, making it
  * ideal for using together with other [Stream]s.
  */
@@ skipping 16 matching lines @@
    *
    * Call [close](inherited from [IOSink]) to only close the [Socket]
    * for sending data.
    */
   void destroy();
 
   /**
    * Use [setOption] to customize the [RawSocket]. See [SocketOption] for
    * available options.
    *
-   * Returns [true] if the option was set successfully, false otherwise.
+   * Returns [:true:] if the option was set successfully, false otherwise.
    */
   bool setOption(SocketOption option, bool enabled);
 
   /**
    * Returns the port used by this socket.
    */
   int get port;
 
   /**
    * Returns the remote port connected to by this socket.
@@ skipping 30 matching lines @@
  * The [RawDatagramSocket] is a low-level interface to an UDP socket,
  * exposing the raw events signaled by the system. It's a [Stream] of
  * [RawSocketEvent]s.
  *
  * Note that the event [RawSocketEvent.READ_CLOSED] will never be
  * received as an UDP socket cannot be closed by a remote peer.
  */
 abstract class RawDatagramSocket extends Stream<RawSocketEvent> {
   /**
    * Set or get, if the [RawDatagramSocket] should listen for
-   * [RawSocketEvent.READ] events. Default is [true].
+   * [RawSocketEvent.READ] events. Default is [:true:].
    */
   bool readEventsEnabled;
 
   /**
    * Set or get, if the [RawDatagramSocket] should listen for
-   * [RawSocketEvent.WRITE] events. Default is [true].  This is a
+   * [RawSocketEvent.WRITE] events. Default is [:true:].  This is a
    * one-shot listener, and writeEventsEnabled must be set to true
    * again to receive another write event.
    */
   bool writeEventsEnabled;
 
   /**
    * Set or get, whether multicast traffic is looped back to the host.
    *
    * By default multicast loopback is enabled.
    */
@@ skipping 106 matching lines @@
     }
     if (address != null) {
       sb.write(", address = ${address.host}");
     }
     if (port != null) {
       sb.write(", port = $port");
     }
     return sb.toString();
   }
 }