unfold.rb in facets-3.0.0

- old
+ new

@@ -1,9 +1,14 @@
 class String
 
-  # Unfold paragrpahs.
+  # Unfold paragraphs such that new lines are removed from between
+  # sentences of the same paragraph.
   #
-  # FIXME: Sometimes adds one too many blank lines. TEST!!!
+  # Note that #rstrip is called on the final result, but this may
+  # change in the future.
+  #
+  # FIXME: Sometimes adds one too many blank lines, which is why we are
+  #         using rstrip. Fix and probably remove the rstrip.
   #
   def unfold
     blank = false
     text  = ''
     split(/\n/).each do |line|