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

From: Sakari Ailus

Date: Wed Jul 15 2026 - 08:44:36 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.
>
> Signed-off-by: Ricardo Ribalda <ribalda@xxxxxxxxxxxx>

Acked-by: Sakari Ailus <sakari.ailus@xxxxxxxxxxxxxxx>

--
Sakari Ailus