From: John Wells <lists@...>
Date: 2006-01-30T22:40:55+09:00
Subject: Re: Incorporating gem documentation into ri

Eric Hodel wrote:
>> rrails-1.0.0/lib/rails_generator/generators/components/controller/ 
>> templates/controller.rb:3:15:
>> Expected class name or '<<'. Got RubyToken::TkLT: "<"
>>
>> Then it just sits there....never completing.
>>
>> Any idea what might be causing this?
> 
> RDoc looks for RDoc in .rb files.  Since that file is not a ruby
> file, RDoc needs to be told not to attempt to scan it.
> 
> For the Rails gem, the Rakefile tells RDoc not to scan this file.
> You should follow its wisdom.
> 
> The other way to prevent/include files in RDoc's search is
> with .document files containing the names of files and paths to
> document.

Hmmm...you're right...this doesn't look like a true Ruby file, although 
it'll be difficult to filter it out because of it's .rb extension.

How does the Rakefile know what to scan and what not? I guess that'll be 
my next area of research. Would it be easier to modify gem itself to do 
this task? Perhaps this should be a candidate for inclusion as an option 
to gem?

Thanks!
John

-- 
Posted via http://www.ruby-forum.com/.