From: sonots@... Date: 2017-10-21T07:48:14+00:00 Subject: [ruby-core:83434] [Ruby trunk Misc#14037] Writing doxygen document comments to static functions Issue #14037 has been updated by sonots (Naotoshi Seo). https://github.com/ruby/ruby/pull/1722 ---------------------------------------- Misc #14037: Writing doxygen document comments to static functions https://bugs.ruby-lang.org/issues/14037#change-67401 * 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: