From: Paul Brannan <pbrannan@...>
Date: 2002-07-23T00:36:10+09:00
Subject: Re: rdtool and rdoc

On Tue, Jul 23, 2002 at 12:28:23AM +0900, Dave Thomas wrote:
> So... A suggestion. I'd like to propose RDoc as the tool used to
> document Ruby libraries and the Ruby interpreter itself. We could use
> the text from the PickAxe for the interpreter documentation and for
> many of the libraries, and the others could be added as we go along.

I think this is an intriguing idea.

How does RDoc handle multiple languages, though?  I think for your
suggestion to work, it would have to make sure that there are at least
english and japanese docs.  As Ruby grows, documenation in more and more
languages would be wanted.  If you stick with inline documentation, then
eventually you will end up with more documentation than code.

Does RDoc have a mechanism for dealing with this?

Paul