But there's no assurance that the people responsible for correcting
this
follow the ruby-doc list.
Good to know
Who IS responsible for this?
But there's no assurance that the people responsible for correcting
this
follow the ruby-doc list.
Good to know
Who IS responsible for this?
Anyone who is a Ruby committer can fix this. For example, Gavin Sinclair, who presumably _is_ on the ruby-doc list, can add missing documentation.
In this case, I added the missing description just now.
The reason that it was reporting the documentation for the _wrong_ method was (vaguely) interesting. A whole bunch of methods are callbacks which have no effect in the core interpreter---they are intended to be overridden by user-level classes. In the interpreter, all these methods point to one underlying C method. If there's no overriding documentation, then the documentation for that method is used by RDoc. In this case, that documentation just happened to be for singleton_method_undefined.
Anyway, in general the answer to the question "who's responsible?" is "we all are." Anyone finding missing or incorrect documentation can submit a patch to ruby-core and someone there should apply it.
Cheers
Dave
On Aug 29, 2004, at 23:22, Mehr, Assaph (Assaph) wrote:
Who IS responsible for this?
Yeah, just gotta reactivate that CVS account
Gavin
On Monday, August 30, 2004, 10:56:47 PM, Dave wrote:
On Aug 29, 2004, at 23:22, Mehr, Assaph (Assaph) wrote:
Who IS responsible for this?
Anyone who is a Ruby committer can fix this. For example, Gavin
Sinclair, who presumably _is_ on the ruby-doc list, can add missing
documentation.
Dave Thomas wrote:
Who IS responsible for this?
Anyone who is a Ruby committer can fix this. For example, Gavin Sinclair, who presumably _is_ on the ruby-doc list, can add missing documentation.
In this case, I added the missing description just now.
The reason that it was reporting the documentation for the _wrong_ method was (vaguely) interesting. A whole bunch of methods are callbacks which have no effect in the core interpreter---they are intended to be overridden by user-level classes. In the interpreter, all these methods point to one underlying C method. If there's no overriding documentation, then the documentation for that method is used by RDoc. In this case, that documentation just happened to be for singleton_method_undefined.
Anyway, in general the answer to the question "who's responsible?" is "we all are." Anyone finding missing or incorrect documentation can submit a patch to ruby-core and someone there should apply it.
Though in this case it did not appear to so much be a matter of missing docs, but something else, where docs from one method were being carried over to a different ri file.
Thanks,
James
On Aug 29, 2004, at 23:22, Mehr, Assaph (Assaph) wrote: