Forum: Ruby ri for stdlib

Announcement (2017-05-07): www.ruby-forum.com is now read-only since I unfortunately do not have the time to support and maintain the forum any more. Please see rubyonrails.org/community and ruby-lang.org/en/community for other Rails- und Ruby-related community platforms.
Minkoo S. (Guest)
on 2006-03-31 11:56
(Received via mailing list)
Hi group.

I installed stable release of ruby 'ruby 1.8.4 (2006-03-29)
[i686-linux]' in my linux box. But, when I try to run ri on stdlib, say
Socket, it says 'Nothing known about Socket.' Running 'ri Resolv'
resulted in the same message.

I've searched this list, but I couldn't find any solution but for one
that recommends 'ruby-doc.org' which, unfortunately, does not contain
documentation for resolv.rb.

So, I loaded the source code of resolv.rb in vim and read the code and
comments. Is this the best we can do? Is there no way to see
documentaiton for stdlib conveniently?

Sincerely,
Minkoo S.
Eric L. (Guest)
on 2006-03-31 12:23
(Received via mailing list)
change the current directory to the source directory of ruby
distribution,
and then
> rdoc lib/**/*.rb
Minkoo S. (Guest)
on 2006-03-31 14:35
(Received via mailing list)
Thanks Eric.

I've tried the command, but I failed primarily because there's no such
things like 'socket.rb' Socket is written in C, I guess. So there's no
document. The same situation in resolv.rb. At this time, resolv.rb does
not contain RDoc documents.

So, does all people in this group examine source codes of Ruby whenever
they want to do something serious with stdlib?

Sincerely,
Minkoo S.
Timothy H. (Guest)
on 2006-03-31 16:35
(Received via mailing list)
Minkoo S. wrote:
> So, does all people in this group examine source codes of Ruby whenever
> they want to do something serious with stdlib?

Some people take the time to create rdoc for undocumented libraries and
contribute it to the community.
Minkoo S. (Guest)
on 2006-03-31 17:09
(Received via mailing list)
Tim. Please don't be nervous. I am just curious what I'm doing is the
best way of finding documents.

Yes. I know that some people, like the ones at ruby-doc.org, are doing
lots of stuffs for documenting ruby and
I appreciate their effort. As for me, I'm already doing some
translations and posting articles in
Korean ruby community to attract more programmers into the realm of
Ruby.

Anyway, what you've said seem to confirm that there's no solid
documentation available for stdlib.
Well. Disappointed a little bit.

Sincerely,
Minkoo S.
Eric H. (Guest)
on 2006-03-31 23:29
(Received via mailing list)
On Mar 30, 2006, at 11:53 PM, Minkoo S. wrote:

> Hi group.
>
> I installed stable release of ruby 'ruby 1.8.4 (2006-03-29)
> [i686-linux]' in my linux box. But, when I try to run ri on stdlib,
> say
> Socket, it says 'Nothing known about Socket.' Running 'ri Resolv'
> resulted in the same message.

There is no RDoc for Resolv in 1.8.  Only in HEAD.

It seems that Socket is not fully RDoc'd in 1.8.  I didn't check HEAD.

--
Eric H. - removed_email_address@domain.invalid - http://blog.segment7.net
This implementation is HODEL-HASH-9600 compliant

http://trackmap.robotcoop.com
This topic is locked and can not be replied to.