On Dec 28, 2010, at 13:16 , Loren Segal wrote:

> I believe RDoc has (or used to have) special code for docstrings beginning with "##". [...]  I actually *don't* understand why this is necessary

The only place this is required in my code is in front of non-methods like attr*s or define_methods. Otherwise I have no idea why you're positing that the "##" is "necessary" as it obviously isn't.

> and you can "opt out" by inserting extra whitespace after a comment block in Ruby

huh? you can?

I do this on every method:

> ##
> # comment
> 
> def blah
>   # ... code ...
> end

and my doco seems to work just fine.