Diffstat (limited to 'lib/rexml/comment.rb')
1 files changed, 4 insertions, 1 deletions
diff --git a/lib/rexml/comment.rb b/lib/rexml/comment.rb
index e439ddf9d89..7c3e79fe2a8 100644
@@ -39,7 +39,10 @@ module REXML
# indentation will be this number of spaces, and children will be
# indented an additional amount.
- # Who knows?
+ # If transitive is true and indent is >= 0, then the output will be
+ # pretty-printed in such a way that the added whitespace does not affect
+ # the absolute *value* of the document -- that is, it leaves the value
+ # and number of Text nodes in the document unchanged.
# Internet Explorer is the worst piece of crap to have ever been
# written, with the possible exception of Windows itself. Since IE is