Subject: Doxygen-styled comments [was: Re: [PATCH v2 09/27] strvec: introduce new `strvec_splice()` function]

From: Toon Claes <[email-masked]>
Date: Thu, 21 Nov 2024 11:23:47 +0100

Jeff King <[email-masked]> writes:

> On Thu, Nov 21, 2024 at 08:13:49AM +0900, Junio C Hamano wrote:
>
>> let's not insist
>> on adding/deleting double-asterisks in new code during the review,

Okay, understood.

>> and let's not churn existing code with a patch that only adds more
>> double-asterisks or removes existing ones.
>
> Like you, I would be happy not to see patches adding or removing them in
> existing code.

Oh yeah, I agree at this point it doesn't make sense.

> To me the point of an official declaration is just to
> tell people not to do so. :)

What do you mean? Do you want to formalize in the contribution docs we
will not accept patches only changing the formatting of code comments?

--
Toon