Misc #14037: Writing doxygen document comments to static functions

• Status: Open
• Assignee: -

[sonots (Naotoshi Seo)]

I often feel that C API documents are lacked in C source codes, especially for static functions.

With https://bugs.ruby-lang.org/issues/904, make install-capi target was introduced to generate c api documents using Doxygen.
However, I feel that it is not utilized among C Ruby developers.

I propose to turn EXTRACT_STATIC = YES flag of Doxygen to YES, and write document comments for static functions as much as possible.

[sonots (Naotoshi Seo)]

https://github.com/ruby/ruby/pull/1722