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