=begin
RDoc truncates files at 1024 bytes when checking if the file is binary. This will invalidate the file encoding if the file is truncated in the middle of a utf8 char and cause RDoc to exit.
I found this problem when running rdoc on the ruby 1.9.2 source.
I find it confusing knowing where to create an RDoc issue: RubyForge or here -- so I've created an issue in both places.
This gist: http://gist.github.com/561350 (possible_fix.rb) shows how I changed RDoc::Parser.binary? locally -- but I don't think it is correct to classify all utf8 files which are invalid when truncated at 1024 bytes as binary.
That same gist (show_parsing_error.rb) also shows another strategy for solving the invalid encoding issue but there are probably better ways to determine if a file is binary.
=end
=begin
Interesting ... the problem does not occur when running rdoc included in ruby built with the v1_9_2_0 tag. I had thought it would -- but the RDoc::Parser.binary? method I reference above which I believe causes the problem: http://github.com/ruby/ruby/blob/trunk/lib/rdoc/parser.rb#L70 is from trunk -- appears to be identical??