From: Chris White <xxx@...>
Date: 2003-12-29T13:26:49+09:00
Subject: Re: RDOC generation broken in 1.8.1?

Ok, I think I figured out what I was doing wrong.  After I built Ruby 1.8.1,
I ran "nmake DESTDIR=<installdir> install" to install Ruby to another
directory.  Then, I ran rdoc on the "installed" version of Ruby, not the
source code version of Ruby.  I guess rdoc needs access to all the source
(which, of course, does not all get installed to the INSTALL directory).

-Chris


"Chris White" <xxx@xxx.net> wrote in message
news:AJNHb.7902$Vv2.3451317@news1.news.adelphia.net...
> I'm very new to Ruby, but I have successfully built and installed Ruby
1.8.1
> from the source code (using the VC7 compiler).  However, when I use rdoc
to
> generate Ruby documentation, I get the following error messages towards
the
> end of the rdoc process:
>
> Generating CHM...
> E:/Ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:419:in
> `build_method_detail_list': undefined
> method `as_href' for nil:NilClass (NoMethodError)
>         from E:/Ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:416:in
> `map'
>         from E:/Ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:416:in
> `build_method_detail_list
> '
>         from E:/Ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:401:in
> `each'
>         from E:/Ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:401:in
> `build_method_detail_list
> '
>         from E:/Ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:399:in
> `each'
>         from E:/Ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:399:in
> `build_method_detail_list
> '
>         from E:/Ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:398:in
> `each'
>         from E:/Ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:398:in
> `build_method_detail_list
> '
>          ... 8 levels...
>         from
E:/Ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:1087:in
> `generate'
>         from E:/Ruby/lib/ruby/1.8/rdoc/generators/chm_generator.rb:38:in
> `generate'
>         from E:/Ruby/lib/ruby/1.8/rdoc/rdoc.rb:210:in `document'
>         from E:/Ruby/bin/rdoc.bat:70
>
>
> I am using the following command line for rdoc:
>
> rdoc --fmt chm --op E:\Ruby\doc
>
>
> ruby --version outputs: ruby 1.8.1 (2003-12-25) [i386-mswin32]
>
> Am I doing something wrong here, or is there an rdoc bug?  It does
generate
> a bunch of html files in E:\Ruby\doc, but there also appear to be missing
a
> bunch of files, plus the .chm file is never generated.  Thanks.
>
> -Chris
>
>