From: Dave Thomas <dave@...>
Date: 2004-02-12T14:16:50+09:00
Subject: Re: Standard libraries


On Feb 11, 2004, at 20:40, NAKAMURA, Hiroshi wrote:
> RDoc style is a must?  I don't like documentation buried within
> a source code (code duplication for me).

I think one style is a good idea: whether it's RDoc or something else I 
don't really mind, but all code should use it.

I'm not sure, though, how RDoc adds duplication. Unlike every other 
style of documentation out there, RDoc actually extracts a fair amount 
of documentation from the actual executable source code, meaning that 
your have to write considerably less documentation than you would with 
rdtool or (say) html.


Cheers

Dave