More comments to StringBuffers.

sdk/lib/core/string_sink.dart

Index: sdk/lib/core/string_sink.dart
diff --git a/sdk/lib/core/string_sink.dart b/sdk/lib/core/string_sink.dart
index c2eff2d79f069e0cd46c2b4e75875fb400e62bdc..04650f7014f49c6516fa741a257bd105b2db92ba 100644
--- a/sdk/lib/core/string_sink.dart
+++ b/sdk/lib/core/string_sink.dart
@@ -7,8 +7,8 @@ part of dart.core;
 abstract class StringSink {
 
   /**
-   * Converts [obj] to a String by invoking [:toString:] and adds the result to
-   * this [StringSink].
+   * Converts [obj] to a String by invoking `toString` and adds the result to
+   * `this`.
    */
   void write(Object obj);
 
@@ -18,15 +18,15 @@ abstract class StringSink {
   void writeAll(Iterable objects);
 
   /**
-   * Converts [obj] to a String by invoking [:toString:] and adds the result to
-   * this [StringSink]. Then adds a new line.
+   * Converts [obj] to a String by invoking `toString` and adds the result to
+   * `this`. Then adds a new line.
    */
   void writeln(Object obj);
 
   /**
-   * Writes the [charCode] to this [StringSink].
+   * Writes the [charCode] to `this`.
    *
-   * This method is equivalent to [:write(new String.fromCharCode(charCode)):].
+   * This method is equivalent to `write(new String.fromCharCode(charCode))`.
    */
   void writeCharCode(int charCode);
 }