From: Austin Ziegler <austin@...>
Date: 2002-10-14T10:47:02+09:00
Subject: Problem with rdoc?

I've done some translation of some Perl packages to Ruby, and I'm 
trying to get them ready for distribution, which means documentation 
and packaging system choices. I'm trying to use rdoc. I was using the 
version that came with the 1.7/Windows version, and then I downloaded 
and installed rdoc beta-2. I'm now getting this result -- and I can't 
figure out why.

c:/Apps/Ruby/lib/ruby/site_ruby/1.7/markup/simple_markup/to_html.rb:20
5:in `html_list_name': Invalid list type (RuntimeError)
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/markup/simple_markup/to_html.rb:82
:in `accept_list_start'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/markup/simple_markup/fragments.rb:
170:in `accept'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/markup/simple_markup/fragments.rb:
163:in `each'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/markup/simple_markup/fragments.rb:
163:in `accept'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/markup/simple_markup.rb:257:in`con
vert'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/rdoc/generators/html_generator.rb:
202:in `markup'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/rdoc/generators/html_generator.rb:
610:in `value_hash'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/rdoc/generators/html_generator.rb:
632:in `write_on'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/rdoc/generators/html_generator.rb:
981:in `gen_into'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/rdoc/generators/html_generator.rb:
981:in `open'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/rdoc/generators/html_generator.rb:
981:in `gen_into'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/rdoc/generators/html_generator.rb:
977:in `each'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/rdoc/generators/html_generator.rb:
977:in `gen_into'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/rdoc/generators/html_generator.rb:
964:in `generate_html'
        from 
c:/Apps/Ruby/lib/ruby/site_ruby/1.7/rdoc/generators/html_generator.rb:
891:in `generate'
        from c:/Apps/Ruby/lib/ruby/site_ruby/1.7/rdoc/rdoc.rb:206:in 
`document'
        from c:\Apps\Ruby\bin\rdoc.rb:6

I'm debating, as well, whether I will use rpkg, rubygems, or the 
"setup" script that I've seen -- what makes the difference between 
these?

-austin
-- Austin Ziegler, austin@halostatue.ca on 2002.10.13 at 21.29.34