From: Stefan Lang <langstefan@...>
Date: 2005-11-27T01:46:55+09:00
Subject: Re: rake + gems + rdoc - broken?

On Saturday 26 November 2005 17:32, itsme213 wrote:
> Gems which previously used to install with rdocs (available via the
> gems rdoc server) don't seem to do so any more. And "rake rdoc"
> dies. Anyone else having similar behaviors?
>
> Thanks.
>
[...]
>
> C:\ruby\lib\ruby\gems\1.8\gems\wee-0.10.0>cd ..\nitro-0.25.0
>
> C:\ruby\lib\ruby\gems\1.8\gems\nitro-0.25.0>rake rdoc
> (in C:/ruby/lib/ruby/gems/1.8/gems/nitro-0.25.0)
> rm -r rdoc
>
> unrecognized option `--all --inline-source'
>
> For help on options, try 'rdoc --help'
>
> rake aborted!
> exit
>
> (See full trace by running task with --trace)
>
> C:\ruby\lib\ruby\gems\1.8\gems\nitro-0.25.0>

The problem is a combination of rake 0.6.99.2 and nito's Rakefile.
The line

      rd.options << '--all --inline-source'

should be changed to
 
      rd.options << '--all' << '--inline-source'

Explanation:
Options is an array, and each element is interpreted as a single
argument to rdoc. It was no problem with later rake versions,
since then rake joined all options together to a single space
seperated string anyway and invoked rdoc via shell.
Latest rake (0.6.99.2) invokes rdoc programmatically and so rdoc
gets the argument "--all --inline-source" which is interpreted
as a single (unknown) option.

Regards,
  Stefan