* 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

1 files changed, 8 insertions, 1 deletions

diff --git a/lib/prettyprint.rb b/lib/prettyprint.rb
index 8b33bdf85f..9a90713a4d 100644
--- a/lib/prettyprint.rb
+++ b/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.
   #