4 ms·
Maybe for internal comments. I like having different styles for docstring comments and other comments. /** Frobnicate the weevil with the given ID and retu
by klodolph 7y ago
Maybe for internal comments. I like having different styles for docstring comments and other comments.
/** Frobnicate the weevil with the given ID and return 0 on success.
*
* Locks the weevil during frobnication, which may take a while.
*/
int weevil_frobnicate(const char *id);
The most important part here is the function definition and its types and parameters. Usually, when I'm looking for a function, the name and type is enough to find what I'm looking for. So I want the function declaration to stand out and the docstring to be faded.