From: Lothar Scholz <mailinglists@...>
Date: 2005-07-07T22:13:47+09:00
Subject: Re: Problem generaing RDoc documentation for gems

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