From: Simon Cozens <simon@...>
Date: 2003-02-23T23:47:08+09:00
Subject: Re: embedded docs

Brian Wisti <brian@coolnamehere.com> writes:
> Will ri (or some other doc browser) be available as part of the standard 
> distribution?  I really miss perldoc and was looking for a similar 
> utility for Ruby.

Perhaps the best thing about perldoc is that I can install a new Perl
module and then read its documentation and work out how to use it. In
the Ruby world, I often install a module and then think "Now
what?". If I'm very lucky, there's some documentation buried away in the
module's source tarball somewhere. If I'm only ordinarily lucky, there
might be an example script. Usually, there's neither.

I don't know a good way of fixing this that *doesn't* presuppose a
documentation browser which can go and find documentation about a
specific module in a known, standard place.

-- 
<yrlnry> I think the real problem here is that he is a university CS
professor and therefore knows very little about programming in the real
world, in any languge.