Re: [PATCH] usb: host: octeon-hcd: fix kernel-doc comments
From: Greg Kroah-Hartman
Date: Sun Oct 11 2026 - 12:07:14 EST
On Sat, Aug 22, 2026 at 01:34:55AM +0800, hanzhijian wrote:
> The file has 31 comments that start with "/**" but are not valid
> kernel-doc comments because they lack the "function_name() -" summary
> line. scripts/kernel-doc reports "isn't a kernel-doc comment" for each
> of them, and they are silently dropped from the generated kernel
> documentation.
>
> Add the missing function and enum name lines, and document the values
> of enum cvmx_usb_stage, so all these comments become valid kernel-doc
> and are included in the generated documentation.
>
> Signed-off-by: hanzhijian <hanzhijian1991@xxxxxxxxx>
Full name please.
thanks,
greg k-h