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..f7eb8639aefb774ba3d90b6ec6bdd8caf166054d 100644
--- a/sdk/lib/core/string_sink.dart
+++ b/sdk/lib/core/string_sink.dart
@@ -8,7 +8,7 @@ abstract class StringSink {
 
   /**
    * Converts [obj] to a String by invoking [:toString:] and adds the result to
-   * this [StringSink].
+   * [:this:].

[sra1, 2013/02/19 21:08:45]

Consider using backtick, which is lighter on the eyes:

  * Converts [obj] to a String by invoking `toString` and adds the result to
  * `this`.

[Lasse Reichstein Nielsen, 2013/02/20 09:30:43]

Backtick is not part of the dartdoc spec (in the language spec), but [:...:] is.
That's probably just a case of dartdoc being violently underspecified, but until
it is I prefer using the parts that are there.

[sra1, 2013/02/21 02:05:15]

The spec currently says (copy & paste from
http://www.dartlang.org/docs/spec/latest/dart-language-specification.pdf ):

A token of the form [:code:] or `code` will render code as code in the formatted
output.

[floitsch, 2013/02/21 13:49:03]

Done.

    */
   void write(Object obj);
 
@@ -19,12 +19,12 @@ abstract class StringSink {
 
   /**
    * Converts [obj] to a String by invoking [:toString:] and adds the result to
-   * this [StringSink]. Then adds a new line.
+   * [: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)):].
    */