Re: [PATCH 1/2] media: atomisp: Demote all broken kernel-doc comments

From: Andy Shevchenko

Date: Mon Jun 29 2026 - 11:21:20 EST


On Mon, Jun 29, 2026 at 11:48:28AM +0000, Ricardo Ribalda wrote:
> The atomisp code has been very heavily annotated in doxygen format.
>
> Unfortunately, both doxygen and kernel-doc use the same mark for signify
> the beginning of a comment (/**).
>
> As a result of this, kernel-doc gets confused when it parses atomisp and
> throws tons of warnings, which made us completely disable atomisp
> kernel-doc checks in Media-CI.
>
> Demote all the broken comments so we can have 100% coverage.
>
> Future patches can convert the doxygen annotations to kernel-doc if this
> is deemed useful.

I haven't checked carefully, but assuming this is just mechanical change of
/** to /* I am fine with it.

Reviewed-by: Andy Shevchenko <andriy.shevchenko@xxxxxxxxx>

--
With Best Regards,
Andy Shevchenko