Lighthouse has a new layout. Prefer the old one? Return to the old layout, and switch back any time from the link at the top of each page.

This project is archived and is in readonly mode.

gem install rails 3.0.0 crashes without building rdocs

#5499

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

Reported by Steven · August 30th, 2010 @ 07:55 PM

State: invalid
Milestone: none
Assigned to: Rohit Arondekar Rohit Arondekar
Importance: Low

Activity

  1. bhauff
    bhauff

    I get this same error. However, it only occurs in 1.8.7, not 1.9.2

    September 3rd, 2010 @ 05:48 PM

  2. Marko Anastasov
    Marko Anastasov

    I can confirm this happening on Linux as well: http://gist.github.com/565967

    September 5th, 2010 @ 12:36 PM

  3. David Trasbo
    David Trasbo

    I was unable to reproduce this issue.

    I switched to ruby-1.8.7-p302 (the latest) with rvm, created a rails3 gemset, and did a gem install rails. It ran all the way through without errors or warnings - I didn't get the Unhandled special error for the builder ri docs either. My RubyGems is version also the latest, 1.3.7, and I'm on OS X.

    What's missing?

    September 5th, 2010 @ 06:14 PM

  4. Marko Anastasov
    Marko Anastasov

    I was able to solve the problem by upgrading the rdoc gem.

    September 9th, 2010 @ 12:23 PM

  5. David Trasbo
    David Trasbo
    • Assigned user set to Rohit Arondekar

    Marko,

    Oh right yes. Well, awesome. This ticket can be closed.

    September 9th, 2010 @ 01:10 PM

  6. Rohit Arondekar
    Rohit Arondekar
    • State changed from new to invalid
    • Importance changed from to Low

    September 9th, 2010 @ 01:18 PM