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..1605ac94f5d627969cc226798d9df4e60ae39539 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 [dart-core.Object.toString] and 

[Emily Fortuna, 2014/01/09 18:21:57]

You shouldn't need to put the full name here. Just [toString] should suffice.

[Alan Knight, 2014/01/09 18:47:28]

Done.

+   * 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 [dart-core.Object.toString] and 
+   * adds the result to `this`, followed by a newline.
    */
   void writeln([Object obj = ""]);