I’m releasing a very preliminary version of ‘ri’ for Ruby 1.8. This
includes documentation on two new built-in classes and a new built-in
module. It also includes roughly 130 new or significantly modified
methods.
I’m very interested in getting feedback on the content, particularly on
missing or incorrectly described methods. In particular, be on the
lookout for old methods that now take new kinds of parameters or return
new kinds of objects: I’m likely to have missed some of these.
I’m releasing a very preliminary version of ‘ri’ for Ruby 1.8. This
includes documentation on two new built-in classes and a new built-in
module. It also includes roughly 130 new or significantly modified
methods.
ri was already pretty comprehensive. Which are the new classes and, if
you have a handy list, the new methods?
I’m very interested in getting feedback on the content, particularly on
missing or incorrectly described methods. In particular, be on the
lookout for old methods that now take new kinds of parameters or return
new kinds of objects: I’m likely to have missed some of these.
I use ri all the time. I’ll get back to you once I’ve played with it a
little.
Ian
···
On Wed 09 Apr 2003 at 23:52:47 +0900, Dave Thomas wrote:
Ian Macdonald | “We Americans, we’re a simple people… but
System Administrator | piss us off, and we’ll bomb your cities.” ian@caliban.org | – Robin Williams, Good Morning Vietnam http://www.caliban.org |
>
Is there any way to extend ri with my own libraries? I use it all the
time, and I have a bad memory for my own code, not just others, I’d
like to be able to generate ri-style documentation.
Is it feaseable? Has anybody done anything to get this into the standard
ruby distribution? It and irb are a killer combination for learning
ruby.
Sam
Quoteing dave@pragprog.com, on Wed, Apr 09, 2003 at 11:52:47PM +0900:
···
I’m releasing a very preliminary version of ‘ri’ for Ruby 1.8. This
includes documentation on two new built-in classes and a new built-in
module. It also includes roughly 130 new or significantly modified
methods.
I’m very interested in getting feedback on the content, particularly on
missing or incorrectly described methods. In particular, be on the
lookout for old methods that now take new kinds of parameters or return
new kinds of objects: I’m likely to have missed some of these.
I’m very interested in getting feedback on the content, particularly on
I haven’t looked at this distribution, but one thing I am missing in ri 1.7
is the support for built in keywords in Ruby. F.eks. “ri if” or “ri ensure”.
ri was comprehensive for Ruby 1.6(.1) - the new one is comprehensive
(in theory) for Ruby 1.8. The new classes are Process::Status and
UnboundMethod, and the new module is Signal. I’ll be producing a method
list at some point, but I wanted to start getting feedback now.
Cheers
Dave
···
On Wednesday, April 9, 2003, at 11:15 AM, Ian Macdonald wrote:
On Wed 09 Apr 2003 at 23:52:47 +0900, Dave Thomas wrote:
I’m releasing a very preliminary version of ‘ri’ for Ruby 1.8. This
includes documentation on two new built-in classes and a new built-in
module. It also includes roughly 130 new or significantly modified
methods.
ri was already pretty comprehensive. Which are the new classes and, if
you have a handy list, the new methods?
That’s an interesting idea: I’ll keep it in mind for the eventual
rewrite. For now, though, ri is just for documenting the built-in
classes and modules.
Cheers
Dave
···
On Thursday, April 10, 2003, at 11:45 AM, MikkelFJ wrote:
I haven’t looked at this distribution, but one thing I am missing in
ri 1.7
is the support for built in keywords in Ruby. F.eks. “ri if” or “ri
ensure”.
Yes, and possibly. I produced this new ri by updating the PickAxe
sources. However, the publishing situation is somewhat up in the air.
Dave,
Is there anything that the Ruby community should be doing to help
convince Addison-Wesley that a 2nd edition of Programming Ruby would be
a good thing? I paid cold hard cash for the first edition and would do
so for an updated version covering Ruby 1.8 (and I suspect others would
too).
ri was comprehensive for Ruby 1.6(.1) - the new one is
comprehensive
(in theory) for Ruby 1.8. The new classes are Process::Status and
UnboundMethod, and the new module is Signal. I’ll be producing a
method
list at some point, but I wanted to start getting feedback now.
Cheers
I can’t get the .tgz to expand on a windows box. I d/l it twice
thinking it might be a corruption problem. I tried both winzip and
cygwin’s zcat and compress; they all griped it was not a valid
archive. (Yes, I’m unix-savvy.)
Anyone else have this problem?
···
Do you Yahoo!?
Yahoo! Tax Center - File online, calculators, forms, and more
I encountered a problem when install ri on my windows 2000 system.While
I type “install.rb config”, the following error occured:
Generating binary help information
chmod 0755 c:/ruby/lib/ruby/site_ruby/ri
Installing reference material
chmod 0755 c:/ruby/lib/ruby/site_ruby/ri/op
op/cvs -> c:/ruby/lib/ruby/site_ruby/ri/op/cvs
c:/ruby/lib/ruby/1.6/ftools.rb:22:in open': Permission denied - "op/cvs" (Errno ::EACCES) from c:/ruby/lib/ruby/1.6/ftools.rb:22:insyscopy’
from c:/ruby/lib/ruby/1.6/ftools.rb:43:in copy' from c:/ruby/lib/ruby/1.6/ftools.rb:160:ininstall’
from D:\ri\install.rb:180
from D:\ri\install.rb:178:in `each’
from D:\ri\install.rb:178
I don’t know why I have no access to the op/cvs directory.
Despite the extension, it appears to be an uncompressed TAR file and not
a gzipped one. So under Unix or Cygwin, just use ‘tar xf’ instead of
‘tar xzf’, or whatever.
ri was comprehensive for Ruby 1.6(.1) - the new one is
I can’t get the .tgz to expand on a windows box. I d/l it twice
thinking it might be a corruption problem. I tried both winzip and
cygwin’s zcat and compress; they all griped it was not a valid
archive. (Yes, I’m unix-savvy.)
If you got it directly from that link on the page Dave gave, this is a
sourceforge thing: Dave reminded me that this tgz link (with a url
of the form ‘…tgz?download’) actually points to an html page with
the real URL on it. I intend to write a ruby program to get around
this nonsense for next time I want something from sourceforge. I
don’t know when I’ll get time for that though.
Try just untaring it (without the ‘z’). I looks like something
(Sourceforge, perhaps) is uncompressing the file in transit in some
circumstances. If anyone knows what’s causing this please let me know.
Cheers
Dave
···
On Wednesday, April 9, 2003, at 12:29 PM, Michael Campbell wrote:
I can’t get the .tgz to expand on a windows box. I d/l it twice
thinking it might be a corruption problem. I tried both winzip and
cygwin’s zcat and compress; they all griped it was not a valid
archive. (Yes, I’m unix-savvy.)
Hmm - I shouldn’t be shipping the CVS directories in the first place,
but even so I’m not sure why you got this error. For now, could you
manually remove any CVS directories and try again.
Sorry
Dave
···
On Wednesday, April 9, 2003, at 08:24 PM, Xiangrong Fang wrote:
Hi Dave,
I encountered a problem when install ri on my windows 2000 system.While
I type “install.rb config”, the following error occured:
Generating binary help information
chmod 0755 c:/ruby/lib/ruby/site_ruby/ri
Installing reference material
chmod 0755 c:/ruby/lib/ruby/site_ruby/ri/op
op/cvs → c:/ruby/lib/ruby/site_ruby/ri/op/cvs
c:/ruby/lib/ruby/1.6/ftools.rb:22:in `open’: Permission denied -
“op/cvs” (Errno
Despite the extension, it appears to be an uncompressed TAR file
and not
a gzipped one. So under Unix or Cygwin, just use ‘tar xf’ instead
of
‘tar xzf’, or whatever.
Do you Yahoo!?
Yahoo! Tax Center - File online, calculators, forms, and more
On Wednesday, April 9, 2003, at 12:29 PM, Michael Campbell wrote:
I can’t get the .tgz to expand on a windows box. I d/l it twice
thinking it might be a corruption problem. I tried both winzip and
cygwin’s zcat and compress; they all griped it was not a valid
archive. (Yes, I’m unix-savvy.)
Try just untaring it (without the ‘z’). I looks like something
(Sourceforge, perhaps) is uncompressing the file in transit in some
circumstances. If anyone knows what’s causing this please let me know.