rdoc for JSON comes out garbled in Ruby 1.9.1
I have tried this with the source snapshot of Ruby 1.9.1 from today (which includes the updated ext/.document file)
Running rdoc on ext and lib results in generated documentation where the JSON documenation is garbled (not formatted - it shows the "#" and doesn't have linebreaks).
Running "rdoc ext/json/lib/json.rb" produces correctly formatted output (I think) for JSON. So I suppose some of the other files interfere with the doc generation.
Updated by Tichy (Björn Günzel) over 10 years ago
Here is a copy of the first couple of lines of the garbled JSON documentation:
# --- call-seq: source() Returns a copy of the current _source_ string, that was used to construct this Parser. # ---
# = json - JSON for Ruby # # == Description # # This is a implementation of the JSON specification
Updated by mame (Yusuke Endoh) almost 10 years ago
- Status changed from Open to Feedback
- Assignee set to drbrain (Eric Hodel)
Running rdoc on ext and lib results in generated documentation where the JSON documenation is garbled
Sorry, I can't understand what you say, maybe because I'm not
familiar with rdoc. Eric, do you understand the issue?
Let us know:
- What did you do? (Just checkout and make?)
- What did you look?
- What did you expect?
Yusuke Endoh email@example.com
Updated by drbrain (Eric Hodel) almost 10 years ago
- Category set to lib
- Priority changed from Normal to 3
I cannot reproduce this, If I run:
rm -r .ext/rdoc; ./miniruby -I./lib -I.ext/common -I./- -r./ext/purelib.rb ./tool/runruby.rb --extout=.ext -- "./bin/rdoc" --no-force-update --all --op ".ext/rdoc" ext/json
The documentation appears to be fine.