Re: Reporting RI-documentation corrections ?

On Wed, 7 Jul 2004, Dave Thomas wrote:
> On Jul 6, 2004, at 18:58, Lothar Scholz wrote:
>
> > Hmm using Array.flatten as an example method is maybe not very
> > clever.  You should take something that has a "call-seq" and
> > uses that special directive.
>
> Yeah - at the time I wrote that documentation call-seq didn't exist. I
> added it to the description, but should probably add it to the top as
> well.
>

Nice to know that there is a source where one can look for info
about how to write rdoc entries for C code.

After seeing the latest addition (with "call-seq"),

     ...
     * call-seq:
     *   cfg.read_value(key)            -> value
     *   cfg.read_value(key} { |key| }  -> value
     ...

I want to ask:
Should it be '->' or '=>' to indicate the return values?

In the current Ruby source (e.g. "array.c") both forms are used.
Does the difference have any significance, or should all entries
change to using  '->' ?

/Johan Holmberg