Gem install of rails-3.0.3 on ruby-1.8.7-p330 gives rdoc error

Rails
1

On Ubuntu 10.04 with rvm 1.1.7 and the “Christmas” rubies:

  • I get the ERROR messages below for a “fresh”
    ‘gem install rails’ on ruby-1.8.7-p330
  • I get a clean install of rails 3.0.3 on
    ruby-1.9.2-p136 (see below)

peterv@ASUS:~$ rvm --version

rvm 1.1.7 by Wayne E. Seguin ([email protected])
[http://rvm.beginrescueend.com/]

In one terminal : 1.8.7-p330

peterv@ASUS:~$ rvm use 1.8.7
Using /home/peterv/.rvm/gems/ruby-1.8.7-p330
peterv@ASUS:~$ rvm gemset name

peterv@ASUS:~$ # NOTE: only ‘rake’ was present for gem list
peterv@ASUS:~$ gem install rails
Successfully installed activesupport-3.0.3
Successfully installed builder-2.1.2
Successfully installed i18n-0.5.0
Successfully installed activemodel-3.0.3
Successfully installed rack-1.2.1
Successfully installed rack-test-0.5.6
Successfully installed rack-mount-0.6.13
Successfully installed tzinfo-0.3.23
Successfully installed abstract-1.0.0
Successfully installed erubis-2.6.6
Successfully installed actionpack-3.0.3
Successfully installed arel-2.0.6
Successfully installed activerecord-3.0.3
Successfully installed activeresource-3.0.3
Successfully installed mime-types-1.16
Successfully installed polyglot-0.3.1
Successfully installed treetop-1.4.9
Successfully installed mail-2.2.13
Successfully installed actionmailer-3.0.3
Successfully installed thor-0.14.6
Successfully installed railties-3.0.3
Successfully installed bundler-1.0.7
Successfully installed rails-3.0.3
23 gems installed
Installing ri documentation for activesupport-3.0.3…
Installing ri documentation for builder-2.1.2…
ERROR: While generating documentation for builder-2.1.2
… MESSAGE: Unhandled special: Special: type=17, text=“”
… RDOC args: --ri --op
/home/peterv/.rvm/gems/ruby-1.8.7-p330/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.5.0…
Installing ri documentation for activemodel-3.0.3…
Installing ri documentation for rack-1.2.1…
Installing ri documentation for rack-test-0.5.6…
Installing ri documentation for rack-mount-0.6.13…
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.3…
Installing ri documentation for arel-2.0.6…
Installing ri documentation for activerecord-3.0.3…
Installing ri documentation for activeresource-3.0.3…
Installing ri documentation for mime-types-1.16…
Installing ri documentation for polyglot-0.3.1…
Installing ri documentation for treetop-1.4.9…
Installing ri documentation for mail-2.2.13…
Installing ri documentation for actionmailer-3.0.3…
Installing ri documentation for thor-0.14.6…
Installing ri documentation for railties-3.0.3…
Installing ri documentation for bundler-1.0.7…
Installing ri documentation for rails-3.0.3…
File not found: lib

NOTE: this is specific for the rails gem

in another experiment where rails was not

the last entry, this comment was also shown

NOTE: no rdoc is ran here ?

peterv@ASUS:~$

Actually, I removed all the gems (except rake) with
gem uninstall and started over and reproduced this
a second time.

I was able to fix my particular installation with
‘gem install rdoc’ and the explanation for RDoc
version 3 on RDoc 3 - Ruby - Ruby-Forum .

Do I assume correctly there is something broken if
a fresh install gives the errors above.

Later in another terminal ruby-1.9.2-p136:

peterv@ASUS:~$ rvm use 1.9.2
Using /home/peterv/.rvm/gems/ruby-1.9.2-p136
peterv@ASUS:~$ rvm gemset list

gemsets for ruby-1.9.2-p136 (found in
/home/peterv/.rvm/gems/ruby-1.9.2-p136)
global

peterv@ASUS:~$ rvm gemset name

peterv@ASUS:~$ gem list

*** LOCAL GEMS ***

rake (0.8.7)
peterv@ASUS:~$ gem update
Updating installed gems
Nothing to update
peterv@ASUS:~$ rvm use
Using /home/peterv/.rvm/gems/ruby-1.9.2-p136
peterv@ASUS:~$ gem install rails
Successfully installed activesupport-3.0.3
Successfully installed builder-2.1.2
Successfully installed i18n-0.5.0
Successfully installed activemodel-3.0.3
Successfully installed rack-1.2.1
Successfully installed rack-test-0.5.6
Successfully installed rack-mount-0.6.13
Successfully installed tzinfo-0.3.23
Successfully installed abstract-1.0.0
Successfully installed erubis-2.6.6
Successfully installed actionpack-3.0.3
Successfully installed arel-2.0.6
Successfully installed activerecord-3.0.3
Successfully installed activeresource-3.0.3
Successfully installed mime-types-1.16
Successfully installed polyglot-0.3.1
Successfully installed treetop-1.4.9
Successfully installed mail-2.2.13
Successfully installed actionmailer-3.0.3
Successfully installed thor-0.14.6
Successfully installed railties-3.0.3
Successfully installed bundler-1.0.7
Successfully installed rails-3.0.3
23 gems installed
Installing ri documentation for activesupport-3.0.3…
Installing ri documentation for builder-2.1.2…
Installing ri documentation for i18n-0.5.0…
Installing ri documentation for activemodel-3.0.3…
Installing ri documentation for rack-1.2.1…
Installing ri documentation for rack-test-0.5.6…
Installing ri documentation for rack-mount-0.6.13…
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.3…
Installing ri documentation for arel-2.0.6…
Installing ri documentation for activerecord-3.0.3…
Installing ri documentation for activeresource-3.0.3…
Installing ri documentation for mime-types-1.16…
Installing ri documentation for polyglot-0.3.1…
Installing ri documentation for treetop-1.4.9…
Installing ri documentation for mail-2.2.13…
Installing ri documentation for actionmailer-3.0.3…
Installing ri documentation for thor-0.14.6…
Installing ri documentation for railties-3.0.3…
Installing ri documentation for bundler-1.0.7…
Installing ri documentation for rails-3.0.3…
Installing RDoc documentation for activesupport-3.0.3…
Installing RDoc documentation for builder-2.1.2…
Installing RDoc documentation for i18n-0.5.0…
Installing RDoc documentation for activemodel-3.0.3…
Installing RDoc documentation for rack-1.2.1…
Installing RDoc documentation for rack-test-0.5.6…
Installing RDoc documentation for rack-mount-0.6.13…
Installing RDoc documentation for tzinfo-0.3.23…
Installing RDoc documentation for abstract-1.0.0…
Installing RDoc documentation for erubis-2.6.6…
Installing RDoc documentation for actionpack-3.0.3…
Installing RDoc documentation for arel-2.0.6…
Installing RDoc documentation for activerecord-3.0.3…
Installing RDoc documentation for activeresource-3.0.3…
Installing RDoc documentation for mime-types-1.16…
Installing RDoc documentation for polyglot-0.3.1…
Installing RDoc documentation for treetop-1.4.9…
Installing RDoc documentation for mail-2.2.13…
Installing RDoc documentation for actionmailer-3.0.3…
Installing RDoc documentation for thor-0.14.6…
Installing RDoc documentation for railties-3.0.3…
Installing RDoc documentation for bundler-1.0.7…
Installing RDoc documentation for rails-3.0.3…
peterv@ASUS:~$

HTH,

Peter

2

As you are using Rails 3, you have a good option after installing rails
is
to run “bundle install” command from your application, this will install
all
required gems for you.

Another note, I faced many cases in Rails 3 that installation of gems
fail,
and after some researching, the solutions was to add --no-ri --no-rdoc
to
the installation command.

For example, if you want to install rails

gem install rails --no-ri --no-rdoc

Regards,

Ahmed

3

Ahmed A. wrote in post #971296:

As you are using Rails 3, you have a good option after installing rails
is to run “bundle install” command from your application, this will
install all required gems for you.

Thanks, but they are already installed. It is only the generation of
documentation that fails. And I can fix that manually with RDoc 3.

Another note, I faced many cases in Rails 3 that installation of gems
fail, and after some researching, the solutions was to
add --no-ri --no-rdoc to the installation command.

For example, if you want to install rails

gem install rails --no-ri --no-rdoc

Yes indeed, that works, but then, there is no local documentation…

I wanted to report the problem a default ‘gem install rails’ on the
latest ruby 1.8.7 patch showed this problem (but maybe I am doing
something wrong ?).

I also had a problem with my rubygems sources, fixed that, but the
problem with generation of documentation for builder-2.1.2 is still
present on my system.

HTH,

Peter