More comments to StringBuffers.

sdk/lib/core/string_buffer.dart

Index: sdk/lib/core/string_buffer.dart
diff --git a/sdk/lib/core/string_buffer.dart b/sdk/lib/core/string_buffer.dart
index cbfcd6eee2959466b2931248935a9180ea5cc2d5..b27fe44206708fcecf0fb806432220fefa666d71 100644
--- a/sdk/lib/core/string_buffer.dart
+++ b/sdk/lib/core/string_buffer.dart
@@ -14,10 +14,11 @@ class StringBuffer implements StringSink {
   /// Creates the string buffer with an initial content.
   external StringBuffer([Object content = ""]);
 
-  /// Returns the length of the buffer.
+  /// Returns the length of the content that has been accumulated so far.
+  /// This operation is in O(1).

[Lasse Reichstein Nielsen, 2013/02/20 09:32:16]

It uses /** below and /// here. Please use /** for consistency.
Change "is in O(1)" to "is a constant time operation". It's too technical. Ditto
below.

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

Done.

   external int get length;
 
-  /// Returns whether the buffer is empty.
+  /// Returns whether the buffer is empty. This operation is in O(1).
   bool get isEmpty => length == 0;
 
   /**