From: Toon Claes <toon@iotcl.com>
Date: Thu, 21 Nov 2024 10:23:47 GMT
Subject: Doxygen-styled comments [was: Re: [PATCH v2 09/27] strvec: introduce new `strvec_splice()` function]
Message-ID: <87plmosx58.fsf@gitlab.com>
In-Reply-To: <20241121081146.GA581647@coredump.intra.peff.net>

Jeff King <peff@peff.net> 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