From: Tom <almostobsolete@...>
Date: 2005-07-07T22:40:47+09:00
Subject: Re: Problem generaing RDoc documentation for gems

Thanks, creating the .document file seems to have solved that problem.
Unfortunatly it's now coming up with a new error:

Generating CHM...
c:/ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:1286:in
`initialize': Inv
alid argument - classes/<.html (Errno::EINVAL)
        from
c:/ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:1286:in `ope
n'
        from
c:/ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:1286:in `gen
_into'
        from
c:/ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:1282:in `eac
h'
        from
c:/ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:1282:in `gen
_into'
        from
c:/ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:1270:in `gen
erate_html'
        from
c:/ruby/lib/ruby/1.8/rdoc/generators/html_generator.rb:1190:in `gen
erate'
        from
c:/ruby/lib/ruby/1.8/rdoc/generators/chm_generator.rb:38:in `genera
te'
        from c:/ruby/lib/ruby/1.8/rdoc/rdoc.rb:263:in `document'
        from c:/ruby/bin/rdoc:63

Any ideas?

-tom

Lothar Scholz wrote:
> Hello almostobsolete,
>
> agc> Hi,
>
> agc> I hope this is the right place to ask, I know there's a rails list as
> agc> well but this does seem to me to be a more general problem with my
> agc> setup.
>
> agc> I've been trying to generate CHM documentation for rails by switching
> agc> to "\ruby\lib\ruby\gems.8\gems" and running "rdoc -f chm -o chm_folder
> agc> action* rails-*" but it keeps failing. The last few lines are:
>
> agc>             controller_generator.rb: c.
> agc>                       controller.rb: c
> agc> rails-0.12.1/lib/rails_generator/generators/components/controller/templates/cont
> agc> roller.rb:3:15: Expected class name or '<<'. Got RubyToken::TkLT: "<"
> agc> ..
>
>
> agc> After that it just freezes.
>
> Yes, this is a well known problem. Please post it to the ruby on rails
> mailing list and tell mr. David Heinemeier Hensen that he should fix
> this in the rails package by adding an empty ".document" put this into
> the templates directory. As this templates should not be added to RDOC.
>
> Or even better tell him that this templates should not have the *.rb
> extension.
>
> It's so easy to fix but instead he added a patch to RubyGems
> (has_rdoc specification option) that prevents RDOC generation
> .. oh wait i should stop now before i get too unpolite.
>
> --
>  Best regards,                        emailto: scholz at scriptolutions dot com
>  Lothar Scholz                        http://www.ruby-ide.com
>  CTO Scriptolutions                   Ruby, PHP, Python IDE 's