From: "Peña, Botp" <botp@...>
Date: 2008-03-15T16:17:20+09:00
Subject: Re: standard library documentation

From: Tom Cloyd [mailto:tomcloyd@comcast.net] 
# I don't see where else to go to find out how to use this 
# module. I seem to be missing some essential resource.


1 in gotapi, i found it under core classes (i just type readline under  search, and it gave me the hints)

2 also in noobkit (http://www.noobkit.com/show/ruby/ruby/ruby-core/kernel/readline.html) i like noobkit since it shows the source and you can also add comments

3 qri can also help

botp@pc4all:~$ qri kernel.readline
-------------------------------------------------------- Kernel#readline
     readline(separator=$/)   => string
------------------------------------------------------------------------
     Equivalent to Kernel::gets, except readline raises EOFError at end
     of file.

botp@pc4all:~$ qri readline
------------------------------------------------------ Multiple choices:

     DEBUGGER__::Context#readline, IO#readline, IRB::Locale#readline,
     Kernel#readline, StringIO#readline, Zlib::GzipReader#readline
botp@pc4all:~$ qri kernel.readline
-------------------------------------------------------- Kernel#readline
     readline(separator=$/)   => string
------------------------------------------------------------------------
     Equivalent to Kernel::gets, except readline raises EOFError at end
     of file.


4 ruby-doc can help too

http://www.ruby-doc.org/core/classes/Kernel.html#M005997


there are other references on ruby but they are scattered. there's even one that's very interactive, you can type/edit/execute the examples given.

the book of matz and flanagan is also a great reference, but you'll have to buy it.


kind regards -botp