Project

General

Profile

Actions

Misc #14037

open

Writing doxygen document comments to static functions

Added by sonots (Naotoshi Seo) over 6 years ago. Updated over 6 years ago.

Status:
Open
Assignee:
-
[ruby-core:83433]

Description

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.

Actions

Also available in: Atom PDF

Like0
Like0