From: "mame (Yusuke Endoh)" Date: 2012-07-02T00:54:23+09:00 Subject: [ruby-core:46056] [ruby-trunk - Bug #6666][Assigned] Documentation Improve - rdoc does not know where rb_obj_methods is (#methods) Issue #6666 has been updated by mame (Yusuke Endoh). Status changed from Open to Assigned Assignee set to drbrain (Eric Hodel) Maybe the comment is needed after rb_define_method, not in class.c? - rb_define_method(rb_mKernel, "methods", rb_obj_methods, -1); + rb_define_method(rb_mKernel, "methods", rb_obj_methods, -1); /* in class.c */ Eric, could you check this? -- Yusuke Endoh ---------------------------------------- Bug #6666: Documentation Improve - rdoc does not know where rb_obj_methods is (#methods) https://bugs.ruby-lang.org/issues/6666#change-27665 Author: shevegen (markus heiler) Status: Assigned Priority: Low Assignee: drbrain (Eric Hodel) Category: Target version: 1.9.3 ruby -v: ruby 1.9.3p194 Hi. It seems there is no simple online documentation available what #methods is doing in Ruby: can't find #methods anywhere in the docs really strange the docs are normally quite thorough Upon looking at this, we saw the method defined first in object.c here: object.c: rb_define_method(rb_mKernel, "methods", rb_obj_methods, -1); https://github.com/ruby/ruby/blob/trunk/object.c#L2897 Referring to: class.c: rb_obj_methods(int argc, VALUE *argv, VALUE obj) class.c has the proper rdoc documentation for #methods there. But this does not seem to show up in the online docu. On IRC, Mon_Ouie said that a reference is missing in order to make this work: class.c has the rdoc docu though All that's missing is the /* in class.c */ comment to make rdoc find the method Yeah, the method is documented, but RDoc doesn't know in what file it is defined, since it's not object.c So it needs a /* in class.c */ comment to know where to look for it My request: Could class.c include this comment so that the online documentation will point to the proper #methods documentation? -- http://bugs.ruby-lang.org/