From: Quintus <sutniuq@...>
Date: 2010-10-31T00:34:25+09:00
Subject: Re: Rdoc problem on some gems (like ruby-graphviz)

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am 30.10.2010 16:39, schrieb Jean-Christophe Le Lann:
> Hi,
> 
> One of my computers is running Fedora 12, where I compiled  ruby 1.9.1p376.
> 
> There however, there is a problem with RDoc when I try to install some
> new gems (message below) like ruby-graphviz.
> 
> Any idea what to do ???
> thx
> JCLL
> 
> 
> 
> [root@localhost ~]# gem19 install ruby-graphviz
> <skipped>
> Successfully installed ruby-graphviz-0.9.18
> 1 gem installed
> Installing ri documentation for ruby-graphviz-0.9.18...
> Updating ri class cache with 266 classes...
> Installing RDoc documentation for ruby-graphviz-0.9.18...
> ERROR:  While generating documentation for ruby-graphviz-0.9.18
> ... MESSAGE:   Error while evaluating
> /usr/local/lib/ruby/gems/1.9.1/gems/rdoc-2.3.0/lib/rdoc/generator/template/darkfish/classpage.rhtml:
> undefined method `each' for #<String:0xad61da0> (at
> "r\">Namespace</h3>\n\t\t\t\t<ul class=\"link-list\">\n\t\t\t\t\t")
> ... RDOC args: lib README.rdoc COPYING AUTHORS
> (continuing with the rest of the installation)
> 
> 
> gem19 update --system
> Updating RubyGems
> Nothing to update
> 
> gem19 list -b --local
> *** LOCAL GEMS ***
> doodle (0.2.3)
> haml (2.2.24)
> hanna (0.1.12)
> progressbar (0.9.0)
> rake (0.8.7)
> rdoc (2.3.0)
> ruby-graphviz (0.9.18)
> 
> And then "require 'graphviz'" fails
> 
> 
> 
> 
The error you get during gem installation has nothing to do with the
fact that you can't require graphviz. The installation error just says
that the documentation couldn't be installed.
Why it occurs: It's a problem with hanna. When you have hanna installed,
generating gem documentation doesn't work anymore automatically. You
have to do it manually by using

# hanna --gems graphviz

If you want to avoid the error permenantly, call gem like this:

# gem install graphviz --no-rdoc

Or, if you don't want to use the --no-rdoc flag every time you install
or update gems, put this in your ~/.gemrc

install: --no-rdoc
update: --no-rdoc

This will make RubyGems use the --no-rdoc flag by default for the
"install" and "update" commands.

The error occurs, because RubyGems' automatic documentation mechanism
always sticks to the latest RDoc installed, even if it's the builtin
RDoc (which is 2.4 or 2.5 I think), but the hanna template only works
with RDoc 2.3. That's at least how *I* think it happens.

And yes, I _really_ hope there will be a new version of hanna that works
with the new RDoc and Ruby 1.9, especially 1.9.2-p0.

Vale,
Marvin
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJMzDr3AAoJEGrS0YjAWTKVpIYIAJ4Yx8v3xMHOPczuOikXY/Af
ln2Gzv6SXEsmFCPMO3cmjHgl3gSAS7RaleFrTy1YJM2B5gaBqG3Gfx6dOctIBhg1
HKISyJtqmRk2WlA9jYBZ4Ba+JoiAjEZ5sG3ZNyC85R0pS4jIAlml/KC48mEl4aCX
Oxznbs02CCmQTyIgx9pooWNAaT61bMdQFYkcDWUx99bstPeaDsXrS0AOEhQlXql5
YOjYelwpsjo+BxkNuSokl180v9c3mm+wftNUxewVhvFhWMcMFXtgAH9ylo3Q3bzN
udYvGS+sdWqaqDDSjL6dzaNPFXASvNdAKiWjhSNKnFViV/STXC8mhaWA3jEUNVs=
=rqpM
-----END PGP SIGNATURE-----