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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.