When you do a clean install of rails 3.0.0 (the released
version), the gems install and it starts building the ri
documentation, but then breaks with "File not found: lib" while
trying to create the ri docs for rails-3.0.0. As a result, you
don't get any rdocs installed. I saw a number of mentions of other
people having this problem with earlier betas / rc's, but no
solution. There was one mention of the rails gem not having a lib
directory and you needing to manually create one.
Here is a trace of the problem on Mac OSX 10.6.4 with rvm. I
also included the initial steps to create an empty gemset.
steven$ rvm gemset create rails3
info: Gemset 'rails3' created.
steven$ rvm use 1.8.7@rails3
info: Using ruby 1.8.7 p302 with gemset rails3
steven$ gem list
LOCAL GEMS
bundler (1.0.0.rc.5)
rake (0.8.7)
steven$ gem update
Updating installed gems
Updating bundler
Successfully installed bundler-1.0.0
Gems updated: bundler
Installing ri documentation for bundler-1.0.0...
Installing RDoc documentation for bundler-1.0.0...
steven$ gem update --system
Updating RubyGems
Nothing to update
steven$ gem install rails --version 3.0.0
Successfully installed activesupport-3.0.0
Successfully installed builder-2.1.2
Successfully installed i18n-0.4.1
Successfully installed activemodel-3.0.0
Successfully installed rack-1.2.1
Successfully installed rack-test-0.5.4
Successfully installed rack-mount-0.6.12
Successfully installed tzinfo-0.3.23
Successfully installed abstract-1.0.0
Successfully installed erubis-2.6.6
Successfully installed actionpack-3.0.0
Successfully installed arel-1.0.1
Successfully installed activerecord-3.0.0
Successfully installed activeresource-3.0.0
Successfully installed mime-types-1.16
Successfully installed polyglot-0.3.1
Successfully installed treetop-1.4.8
Successfully installed mail-2.2.5
Successfully installed actionmailer-3.0.0
Successfully installed thor-0.14.0
Successfully installed railties-3.0.0
Successfully installed rails-3.0.0
22 gems installed
Installing ri documentation for activesupport-3.0.0...
Installing ri documentation for builder-2.1.2...
ERROR: While generating documentation for builder-2.1.2
... MESSAGE: Unhandled special: Special: type=17, text="<!-- HI
-->" ... RDOC args: --ri --op
/Users/steven/.rvm/gems/ruby-1.8.7-p302@rails3/doc/builder-2.1.2/ri
--title Builder -- Easy XML Building --main README --line-numbers
--quiet lib CHANGES Rakefile README doc/releases/builder-1.2.4.rdoc
doc/releases/builder-2.0.0.rdoc doc/releases/builder-2.1.1.rdoc
--title builder-2.1.2 Documentation (continuing with the rest of
the installation) Installing ri documentation for i18n-0.4.1...
Installing ri documentation for activemodel-3.0.0...
Installing ri documentation for rack-1.2.1...
Installing ri documentation for rack-test-0.5.4...
Installing ri documentation for rack-mount-0.6.12...
Installing ri documentation for tzinfo-0.3.23...
Installing ri documentation for abstract-1.0.0...
Installing ri documentation for erubis-2.6.6...
Installing ri documentation for actionpack-3.0.0...
Installing ri documentation for arel-1.0.1...
Installing ri documentation for activerecord-3.0.0...
Installing ri documentation for activeresource-3.0.0...
Installing ri documentation for mime-types-1.16...
Installing ri documentation for polyglot-0.3.1...
Installing ri documentation for treetop-1.4.8...
Installing ri documentation for mail-2.2.5...
Installing ri documentation for actionmailer-3.0.0...
Installing ri documentation for thor-0.14.0...
Installing ri documentation for railties-3.0.0...
Installing ri documentation for rails-3.0.0...
File not found: lib