On Thu, Apr 21, 2022 at 08:34:10PM +0200, Victor Toso wrote: > Not sure I understood what is preferable. For all functions and > typdefs and macros, it should be: > > Line > 1 /** > 2 * type_name: > 3 * > 4 * Maybe some comment. > 5 * > 6 * Maybe something about return value. > 7 * > 8 * Since: v1.2.3 > 9 * > 10 */ > > Do you suggest to not have empty line 9 ? Correct. > For enum values, if they are multiple line comments, I try to > follow the above too. Otherwise, to avoid adding lots of extra > empty lines around where we only had a single line as comment > before, I've only appended the Since tag. Yeah, that sounds sensible. I think it would be nice to use the same multi-line, documentation-right-above-symbol style everywhere, but it would most likely become too unwieldy in practice, especially for large enums. -- Andrea Bolognani / Red Hat / Virtualization
