Improve comment formatting in dart-core, especially Comparable

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 16c9f4fecb84453b5b16279490a371cd89ce7bbd..5fdd0f25a35e4497dc0c517ef225cdd1bc59eb14 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`.
+   * Converts [obj] to a String by invoking [Object.toString] and 
+   * adds the result to `this`.
    */
   void write(Object obj);
 
@@ -18,8 +18,8 @@ abstract class StringSink {
   void writeAll(Iterable objects, [String separator = ""]);
 
   /**
-   * Converts [obj] to a String by invoking `toString` and adds the result to
-   * `this`. Then adds a new line.
+   * Converts [obj] to a String by invoking [Object.toString] and 
+   * adds the result to `this`, followed by a newline.
    */
   void writeln([Object obj = ""]);