Jonas Lindström
11/7/2003 11:03:00 AM
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