Trying to RDoc Ruby 1.8.0

[Jonas Lindström]

Hi all,

I have been trying to run RDoc on the source distribution of Ruby 1.8.0.

$ rdoc --version
RDoc V0.9.0: 2003/03/10 03:50:33 (1.70)
$ rdoc --op rdoc

class.c:
struct.c:
dmyext.c:
...

After parsing all source files (about 20 minutes) and printing
"Generating HTML...", RDoc exits with the following error message:

/usr/local/lib/ruby/site_ruby/1.8/rdoc/generators/html_generator.rb:371:in `build_method_detail_list': undefined method `as_href' for nil:NilClass (NoMethodError)
from /usr/local/lib/ruby/site_ruby/1.8/rdoc/generators/html_generator.rb:368:in `map'
from /usr/local/lib/ruby/site_ruby/1.8/rdoc/generators/html_generator.rb:368:in `build_method_detail_list'
from /usr/local/lib/ruby/site_ruby/1.8/rdoc/generators/html_generator.rb:357:in `each'
from /usr/local/lib/ruby/site_ruby/1.8/rdoc/generators/html_generator.rb:357:in `build_method_detail_list'
from /usr/local/lib/ruby/site_ruby/1.8/rdoc/generators/html_generator.rb:355:in `each'
from /usr/local/lib/ruby/site_ruby/1.8/rdoc/generators/html_generator.rb:355:in `build_method_detail_list'
from /usr/local/lib/ruby/site_ruby/1.8/rdoc/generators/html_generator.rb:354:in `each'
from /usr/local/lib/ruby/site_ruby/1.8/rdoc/generators/html_generator.rb:354:in `build_method_detail_list'
... 7 levels...
from /usr/local/lib/ruby/site_ruby/1.8/rdoc/generators/html_generator.rb:1053:in `generate_html'
from /usr/local/lib/ruby/site_ruby/1.8/rdoc/generators/html_generator.rb:979:in `generate'
from /usr/local/lib/ruby/site_ruby/1.8/rdoc/rdoc.rb:210:in `document'
from /usr/local/bin/rdoc:6

I then ran RDoc on each subdirectory in lib, to find out which module
triggered the error. RDoc fails on lib/webrick.

Running RDoc on one file at a time in lib/webrick does not trigger the
error.

I don't know whether RDoc was designed to be run on the entire Ruby
source, so perhaps I am making a mistake by trying to use it that way.

Perhaps someone has already managed to run RDoc (or some other
documentation tool on Ruby 1.8.0 and made it available online?

Jonas Lindström

 

[Dave Thomas]

Hi all,

I have been trying to run RDoc on the source distribution of Ruby
1.8.0.

Let me look at this when I get back off the road.

Dave