Tom Cloyd wrote:
> An example of a puzzle I've run into many times before -
>
> I'm wanting to use the readline module. I go to 
> http://www.gotapi.com/rubystdlib, and look it up, and get a page that 
> tells me essentially nothing that I can use. THIS is documentation? I 
> don't see the point.
>
> I don't see where else to go to find out how to use this module. I 
> seem to be missing some essential resource.
>
> Can anyone help?
>
> t.
>
OK, looking here -
http://adam.blog.heroku.com/past/2008/1/22/using_rubys_readline_library/
I read "There appears to be no documentation 
<http://ruby-doc.org/stdlib/libdoc/readline/rdoc/index.html> for Ruby's 
readline support. What's worse, it's written in C, so you can't (easily) 
read the source to find out its interface." Well, that sure leave ME out 
in the cold. Adam's explanation there is, well, obscure.

I'm playing with various ways of using readline, like

require 'readline'
puts 'test under way'
opt = readline( "=--> \n")
puts( opt)

Nothing works, so far. The code above seems to stop at line 2. Or maybe 
it's 3, but there's no prompt output. We surely never get to line 4.

So...tell me please, what exactly is the point of making undocumented 
software available? I'm never understood this. Seems irresponsible, or 
lazy, or thoughtless. In my case, I'd use this, but...I can't, so...done 
for now. Not exactly a triumph for anyone, I'd say.

What do other people do in this situation? I'm cruising Google, and it's 
a wasteland on this issue, so far. All I'm doing is wasting time here. Sad.

t.

-- 

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Tom Cloyd, MS MA, LMHC
Private practice Psychotherapist
Bellingham, Washington, U.S.A: (360) 920-1226
<< tc / tomcloyd.com >> (email)
<< TomCloyd.com >> (website & psychotherapy weblog) 
<< sleightmind.wordpress.com >> (mental health issues weblog)
<< directpathdesign.com >> (web site design & consultation)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~