From: Yusuke Endoh Date: 2010-04-16T19:10:36+09:00 Subject: [ruby-core:29553] [Bug #2059](Rejected) Marking internal functions as internal Issue #2059 has been updated by Yusuke Endoh. Status changed from Open to Rejected Hi, > All internal (extern) functions should be marked as internal > in Doxygen comments before 1.9.2's release. I strongly object. If a function has no document, it should be considered as function just for internal, by default. We cannot guarantee compatibility of non-documented functions completely. Authors of ext library must use them at the risk. Indeed, many functions have no document, even if the function is really needed (and actually used) by many ext library. The fact is unfortunate. We should respect compatiblity of "behavior" as far as possible. However, undocumented function is undocumented function. Anyway, this is never a bug. So I reject this ticket. Ruby's C API should be reorganized and documented, towards 2.0. Welcome volunteers. -- Yusuke Endoh ---------------------------------------- http://redmine.ruby-lang.org/issues/show/2059 ---------------------------------------- http://redmine.ruby-lang.org