From: Peter Zotov <whitequark@...>
Date: 2011-02-09T11:08:04+09:00
Subject: Re: issue with activerecord

On Wed, 9 Feb 2011 10:55:08 +0900
Paul Na <paulley.net@googlemail.com> wrote:

> Hi all,
> 
> 
> When i tried to install rails. it installs activerecord which is
> ok,also i have tried installing activerecord on its own but i have a
> error:
> 
> Installing ri documentation for activerecord-3.0.4...
> ERROR:  While generating documentation for activerecord-3.0.4
> ... MESSAGE:   Invalid argument - ./</cdesc-<.ri
> ... RDOC args: lib README.rdoc
> (continuing with the rest of the installation)
> Installing RDoc documentation for activerecord-3.0.4...
> ERROR:  While generating documentation for activerecord-3.0.4
> ... MESSAGE:   error generating <.html: Invalid argument -
> C:/Ruby187/lib/ruby/g
> ems/1.8/doc/activerecord-3.0.4/rdoc/<.html (Errno::EINVAL)
> ... RDOC args: lib README.rdoc
> 
> Has anyone got any idea why this is happening and what it means
> 

That error messages mean that RubyGems cannot generate documentation
for the gems you install (activerecord, in this case). Documentation is
not distributed in gems (probably for size reasons); instead, it is
generated from the source code each time when one installs the gem.

Sometimes, due to some incompatibilites in systems/RDoc versions/etc
this process fails. It just means you cannot use your locally generated
documentation (use api.rubyonrails.org instead); this does not affect
usability of the gem. You can install it with
`gem install activerecord --no-ri --no-rdoc`, if you want to get rid of
the errors themselves.

-- 
  WBR, Peter Zotov