Gem/rdoc/ri errors on mingw

ruby-talk
1

Hello,
yesterday I switched from the very good, perfectly functional
one-click installer to a build-it-yourself-ruby-compile on winXP
with the mingw environment.

All went very smoothly.
Great documents on setting up mingw/msys here
http://mingw.org/MinGWiki/index.php/RealDumbQuickstart?PHPSESSID=0691a1dc17253ae9792187c3b78816ad

and Great documents on building ruby on windows here
http://www.rubygarden.org/ruby?HowToBuildOnWindows

Follow this up, by getting ruby-gnome2 setup with this wonderful doc
http://ruby-gnome2.sourceforge.jp/hiki.cgi?Install+Guide+for+Windows

Mingw works! Ruby works! Ruby-Gnome works!

...rdoc doesnt work.. ri doesnt work.. gem doesnt either... big uhohs!!

Here is some output:

$> ruby -v
ruby 1.8.4 (2006-02-14) [i386-mingw32]
$>cd /c/ruby/build/ruby
$> make install-doc
Generating RDoc documentation
./miniruby.exe ./runruby.rb --extout=.ext -- "./bin/rdoc" --all --ri
--op "C:/ruby/share/ri/1.8/system" "."
c:/ruby/build/ruby/lib/tracer.rb:27:in `(null)': undefined method `[]'
for nil:NilClass (NoMethodError)
        from c:/ruby/build/ruby/lib/rdoc/parsers/parse_rb.rb:16:in `(null)'
        from c:/ruby/build/ruby/lib/rdoc/rdoc.rb:8:in `(null)'
        from ./bin/rdoc:59
make: *** [do-install-doc] Error 1
$> gem
sh: gem: command not found
$> rdoc
c:/ruby/lib/ruby/1.8/tracer.rb:27:in `(null)': undefined method `[]'
for nil:NilClass (NoMethodError)
        from c:/ruby/lib/ruby/1.8/rdoc/parsers/parse_rb.rb:16:in `(null)'
        from c:/ruby/lib/ruby/1.8/rdoc/rdoc.rb:8:in `(null)'
        from c:/ruby/bin/rdoc:59
$> ri

Installing Documentation

···

------------------------
'ri' uses a database of documentation built by the RDoc utility.

So, how do you install this documentation on your system? It depends on
how you installed Ruby.

_If you installed Ruby from source files_ (that is, if it some point you
typed 'make' during the process :), you can install the RDoc
documentation yourself. Just go back to the place where you have your
Ruby source and type

   make install-doc

You'll probably need to do this as a superuser, as the documentation is
installed in the Ruby target tree (normally somewhere under
+/usr/local+.

_If you installed Ruby from a binary distribution_ (perhaps using a
one-click installer, or using some other packaging system), then the
team that produced the package probably forgot to package the
documentation as well. Contact them, and see if they can add it to the
next release.

No ri documentation found in:

Was rdoc run to create documentation?
$>

Anyone know how to properly setup a ruby compile so that gem/ri/rdoc
will work as expected? Anyone have a clue why 'make install-doc' fails?

Thanks for any help.

--
Alex Combas
http://noodlejunkie.blogspot.com/

2

Alex Combas schrieb:

$> gem
sh: gem: command not found

This is what I call (ruby one-click-installer on Windows):

1. In my path there is an entry for c:\ruby\bin
2. In my ruby\bin directory, there is a file called gem.bat (this one is started by windows if you type gem)

3. This gem file contains one beautiful line
"c:\ruby\bin\ruby.exe" "c:\ruby\bin\gem" %1 %2 %3 %4 %5 %6 %7 %8 %9

So my guess is, make sure you have the gem ruby file installed (get it from rubyforge? I doesn't exactly know where to download gem as I use the one-click-stuff) and create this batch file.

HTH,

···

--
Daniel Völkerts
Protected by Anti Pesto.

3

Alex Combas wrote:
[...]

Anyone know how to properly setup a ruby compile so that gem/ri/rdoc
will work as expected? Anyone have a clue why 'make install-doc' fails?

Thanks for any help.

http://docs.rubygems.org/read/chapter/3 should help with RubyGems.

···

--
Posted via http://www.ruby-forum.com/\.

4

Thanks Jim, installed gem from ruby forge. Boy, that was easy.

Any clues about rdoc and ri?
Still no worky.

I wonder if documentation is really nessisary though? Sure its nice, but
is there any difference between having it local and viewing it on ruby-doc ?

I guess the difference would be if I ever needed to write my own documentation.

···

On 2/15/06, Jim Weirich <jim@weirichhouse.org> wrote:

http://docs.rubygems.org/read/chapter/3 should help with RubyGems.

--
Alex Combas
http://noodlejunkie.blogspot.com/

5

Thank Daniel,
Yeah I was using the one-click installer which was
really nice, but I figured it would be good to have ruby
built from scratch however it seems there are some hidden gotchas.

I'll post back if I figure out why make-doc isnt working.

···

On 2/14/06, Daniel Völkerts <daniel@voelkerts.de> wrote:

Alex Combas schrieb:

> $> gem
> sh: gem: command not found

This is what I call (ruby one-click-installer on Windows):

1. In my path there is an entry for c:\ruby\bin
2. In my ruby\bin directory, there is a file called gem.bat (this one is
started by windows if you type gem)

3. This gem file contains one beautiful line
"c:\ruby\bin\ruby.exe" "c:\ruby\bin\gem" %1 %2 %3 %4 %5 %6 %7 %8 %9

So my guess is, make sure you have the gem ruby file installed (get it
from rubyforge? I doesn't exactly know where to download gem as I use
the one-click-stuff) and create this batch file.

--
Alex Combas
http://noodlejunkie.blogspot.com/

6

Dňa Streda 15 Február 2006 17:53 Alex Combas napísal:

I wonder if documentation is really nessisary though? Sure its nice, but
is there any difference between having it local and viewing it on ruby-doc
?

Well, the online version is faster than ri :wink:

But at least a working rdoc is somewhat important, I'd say.

David Vallner

7

David Vallner wrote:

Dňa Streda 15 Február 2006 17:53 Alex Combas napísal:

I wonder if documentation is really nessisary though? Sure its nice, but
is there any difference between having it local and viewing it on ruby-doc
?

Well, the online version is faster than ri :wink:

So *that's* why my bandwidth is going through the roof.

:slight_smile:

But at least a working rdoc is somewhat important, I'd say.

I would think so, unless you have a guaranteed Net connection.

···

--
James Britt

"You harmonize; then you customize."
  - Wilson Pickett

8

Dňa Streda 15 Február 2006 23:14 James Britt napísal:

David Vallner wrote:
> Dňa Streda 15 Február 2006 17:53 Alex Combas napísal:
>>I wonder if documentation is really nessisary though? Sure its nice, but
>>is there any difference between having it local and viewing it on
>> ruby-doc ?
>
> Well, the online version is faster than ri :wink:

So *that's* why my bandwidth is going through the roof.

Well, I have a crappy CPU, and a wonderful cable connection.

david@chello082119107152:~$ time ri -T Array#
(snip)
real 0m0.876s
user 0m0.589s
sys 0m0.108s

david@chello082119107152:~$ ping -c 1 ruby-doc.org
PING ruby-doc.org (207.44.206.37) 56(84) bytes of data.
64 bytes from tagbomb.com (207.44.206.37): icmp_seq=1 ttl=53 time=152 ms

And unless you set that wossname header to no-cache globally, the strain can't
be that horrible. At least not from us Opera users.

:slight_smile:
:
> But at least a working rdoc is somewhat important, I'd say.

I would think so, unless you have a guaranteed Net connection.

I meant for documentation generation actually.

David Vallner