From: sonots@... Date: 2017-10-21T07:46:21+00:00 Subject: [ruby-core:83433] [Ruby trunk Misc#14037] Writing doxygen document comments to static functions Issue #14037 has been reported by sonots (Naotoshi Seo). ---------------------------------------- Misc #14037: Writing doxygen document comments to static functions https://bugs.ruby-lang.org/issues/14037 * Author: sonots (Naotoshi Seo) * Status: Open * Priority: Normal * Assignee: ---------------------------------------- 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. -- https://bugs.ruby-lang.org/ Unsubscribe: