Improve comment formatting in dart-core, especially Comparable

sdk/lib/core/function.dart

Index: sdk/lib/core/function.dart
diff --git a/sdk/lib/core/function.dart b/sdk/lib/core/function.dart
index 9514951d1dd5cb1de2a10d070b6262edc7cf2ba8..3eebddcf4f6528cd07430f22e861a57f23d44016 100644
--- a/sdk/lib/core/function.dart
+++ b/sdk/lib/core/function.dart
@@ -21,12 +21,14 @@ abstract class Function {
    * This includes giving the same errors if [function] isn't callable or
    * if it expects different parameters.
    *
-   * Example: [:
-   * Map<Symbol, dynamic> namedArguments = new Map<Symbol, dynamic>();
-   * namedArguments[const Symbol("f")] = 4;
-   * namedArguments[const Symbol("g")] = 5;
-   * Function.apply(foo, [1,2,3], namedArguments); :]
-   * gives exactly the same result as [: foo(1, 2, 3, f: 4, g: 5) :].
+   * Example:
+   *       Map<Symbol, dynamic> namedArguments = new Map<Symbol, dynamic>();
+   *       namedArguments[const Symbol("f")] = 4;
+   *       namedArguments[const Symbol("g")] = 5;
+   *       Function.apply(foo, [1,2,3], namedArguments);
+   *
+   * gives exactly the same result as
+   *       foo(1, 2, 3, f: 4, g: 5).
    *
    * If [positionalArguments] is null, it's considered an empty list.
    * If [namedArguments] is omitted or null, it is considered an empty map.