From: "Earlopain (Earlopain _) via ruby-core" Date: 2026-08-16T14:02:40+00:00 Subject: [ruby-core:126411] [Ruby Misc#14037] Writing doxygen document comments to static functions Issue #14037 has been updated by Earlopain (Earlopain _). Status changed from Open to Closed `EXTRACT_STATIC` is true now (and docs were also added) ---------------------------------------- Misc #14037: Writing doxygen document comments to static functions https://bugs.ruby-lang.org/issues/14037#change-118553 * Author: sonots (Naotoshi Seo) * Status: Closed ---------------------------------------- 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/ ______________________________________________ ruby-core mailing list -- ruby-core@ml.ruby-lang.org To unsubscribe send an email to ruby-core-leave@ml.ruby-lang.org ruby-core info -- https://ml.ruby-lang.org/mailman3/lists/ruby-core.ml.ruby-lang.org/