From: sashiko-bot@kernel.org
To: "Zhijian Han" <hanzhijian1991@gmail.com>
Cc: linux-usb@vger.kernel.org
Subject: Re: [PATCH v2] usb: host: octeon-hcd: fix kernel-doc comments
Date: Mon, 12 Oct 2026 02:15:16 +0000 [thread overview]
Message-ID: <sashiko-outbox-167553@kernel.org> (raw)
In-Reply-To: <20261012021320.3047735-1-hanzhijian1991@gmail.com>
> 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.
>
> Found by running scripts/kernel-doc -none on the file.
>
> Assisted-by: LLM scripts/kernel-doc
> Signed-off-by: Zhijian Han <hanzhijian1991@gmail.com>
Sashiko has reviewed this patch and found no issues. It looks great!
--
Sashiko AI review · https://sashiko.dev/#/patchset/20261012021320.3047735-1-hanzhijian1991@gmail.com?part=1
prev parent reply other threads:[~2026-10-12 2:15 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <20261011133931.GA12345@kroah.com>
2026-10-12 2:13 ` [PATCH v2] usb: host: octeon-hcd: fix kernel-doc comments Zhijian Han
2026-10-12 2:15 ` sashiko-bot [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=sashiko-outbox-167553@kernel.org \
--to=sashiko-bot@kernel.org \
--cc=hanzhijian1991@gmail.com \
--cc=linux-usb@vger.kernel.org \
--cc=sashiko-reviews@lists.linux.dev \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox