* lib/prettyprint.rb: update document. [ruby-core:36776]

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@32818 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

ChangeLog

@@ -1,3 +1,7 @@
+Wed Aug  3 00:11:08 2011  Tanaka Akira  <akr@fsij.org>
+
+	* lib/prettyprint.rb: update document.  [ruby-core:36776]
+
 Tue Aug  2 22:04:46 2011  NARUSE, Yui  <naruse@ruby-lang.org>
 
 	* gc.c (init_heap): allocate sigaltstack after heaps are allocated.

lib/prettyprint.rb

@@ -157,7 +157,14 @@ class PrettyPrint
     end
   end
 
-  # This is similar to #breakable, but is less-likely to insert a newline.
+  # This is similar to #breakable except
+  # the decision to break or not is determined individually.
+  #
+  # Two #fill_breakable under a group may cause 4 results:
+  # (break,break), (break,non-break), (non-break,break), (non-break,non-break).
+  # This is different to #breakable because two #breakable under a group
+  # may cause 2 results:
+  # (break,break), (non-break,non-break).
   #
   # The text sep+ is inserted if a line is not broken at this point.
   #