From: Brian Candler <B.Candler@...>
Date: 2007-03-30T05:52:55+09:00
Subject: Re: Rdoc - ignores Rakefile & Rspecs

On Fri, Mar 30, 2007 at 04:44:42AM +0900, Suraj Kurapati wrote:
> Brian Candler wrote:
> > I think a summary of the problem is: you want rdoc to process a file as 
> > if it were ruby source, but where it has no extension.
> 
> I want rdoc to process a file as if it were ruby source *regardless* of 
> its file extension when it is explicitly specify as a command-line 
> argument.
> 
> For example, this should work:
> 
>   ln foo.rb foo.exe
> 
>   rdoc foo.exe # should treat foo.exe as a ruby source file
> 
>   rdoc put_odd_name_here # should treat as ruby source file

But that breaks the very common idiom of:

  rdoc doc/README

which clearly is *not* a ruby source file.

> Nevertheless, I highly prefer *no* file-extension based discrimination, 
> because it is simple and straightforward, over these 
> special-case-provision alternatives.

Whilst breaking the majority of existing users of rdoc. I guess your
solution would require them to rename plain text files to *.txt

Brian.