[lnkForumImage]
TotalShareware - Download Free Software

Confronta i prezzi di migliaia di prodotti.
Asp Forum
 Home | Login | Register | Search 


 

Forums >

comp.lang.ruby

Re: RDoc and i18n

Dave Thomas

10/21/2003 6:13:00 PM


On Tuesday, Oct 21, 2003, at 13:08 US/Central, Austin Ziegler wrote:

> # :class: Foo
> # documentation for class Foo.
> # :method: Foo.bar
> # documentation for class method Foo.bar
> # :method: Foo#bar
> # documentation for instance method Foo#bar.
>

On the face of it, I'm not too keen on this kind of approach. The
philosophy of RDoc is make document transparent, and in the same source
file as the code.

We've all seen the problems that arise now when documentation is
separate from code, and the code changes. I'd like to try to avoid this.

Cheers


Dave