From: "Jonas Lindström" <jonas.li@...>
Date: 2003-11-07T20:03:21+09:00
Subject: Trying to RDoc Ruby 1.8.0

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