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

Ok, the only way I can get this to work is to run rdoc from the lib
directory of the source distribution.  But, when I run in the lib directory
of the installed Ruby tree, it fails.  Then, when I go to the "ext"
directory in the Ruby source distribution, and run rdoc, it fails there.  I
guess that the "lib" directory in the installed version of Ruby is made up
of files from both "ext" and "lib" in the original Ruby source distribution,
and that a file from "ext" is causing the problem with rdoc.


"Chris White" <xxx@xxx.net> wrote in message
news:F_NHb.7910$Vv2.3455100@news1.news.adelphia.net...
> 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
> >
> >
>
>