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]

On Nov 7, 2003, at 6:03, Jonas Lindström wrote:

> 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