I just installed the latest Windows version from Activestate (having
completely removed earlier version) ruby186-25.exe and that is working
fine:
C:\ruby\bin>ruby -v
ruby 1.8.6 (2007-03-13 patchlevel 0) [i386-mswin32]
however when I came to work through tutorials I found Ri wasn’t
working quite as I expected:
C:\ruby\bin>ri String#tr
String#tr
tr(from, to)
(no description...)
according to the tutorial I should get a lot more info about
parameters, example of usage etc. from last time I played with this I
thought it was more informative, have I missed an important step in
the installation?
Nope, you did nothing wrong. At least, that’s the same output I get (on
Linux, having installed Ruby from a package manager). The fact that it
even shows up means it’s working. Otherwise it would say “Nothing known
about String#tr”. Other methods will have better documentation.
Thanks for quick response, I’ve found other functions seem to be
working ok, for example ri String#unpack, produced what my Pickaxe
book tells me about. But I did wonder where someone without the book
would get documentation on that function.
Thanks for quick response, I’ve found other functions seem to be
working ok, for example ri String#unpack, produced what my Pickaxe
book tells me about. But I did wonder where someone without the book
would get documentation on that function.
I love Ruby. And Rails. But I’ve found the lack of documentation to be
its weakest link. Big time. I’m a newbie and have asked other veterans
about this - and they all agree.
according to the tutorial I should get a lot more info about
parameters, example of usage etc. from last time I played with this I
thought it was more informative, have I missed an important step in
the installation?
No; I’m seeing the same problem. For some reason tr isn’t getting
picked up during rdoc/ri generation.
however when I came to work through tutorials I found Ri wasn’t
parameters, example of usage etc. from last time I played with this I
thought it was more informative, have I missed an important step in
the installation?
No; I’m seeing the same problem. For some reason tr isn’t getting
picked up during rdoc/ri generation.
The reason is that rdoc picks empty docs from lib/jcode.rb.
Maybe we should add #:nodoc: to some of the methods in jcode.rb
Thanks for quick response, I’ve found other functions seem to be
working ok, for example ri String#unpack, produced what my Pickaxe
book tells me about. But I did wonder where someone without the book
would get documentation on that function.
–
James B.
“A principle or axiom is of no value without the rules for applying it.”
RDoc, and hence also has broken/missing information on String#tr
Somehow ruby-doc.org has both definitions, empty tr and correct
str.tr. RI picks the first.
Thanks for quick response, I’ve found other functions seem to be
working ok, for example ri String#unpack, produced what my Pickaxe
book tells me about. But I did wonder where someone without the book
would get documentation on that function.