From: Damien Le Moal <dlemoal@kernel.org>
To: Randy Dunlap <rdunlap@infradead.org>, linux-kernel@vger.kernel.org
Cc: Niklas Cassel <cassel@kernel.org>, linux-ide@vger.kernel.org
Subject: Re: [PATCH] ata: libata: avoid kernel-doc warnings
Date: Mon, 27 Jul 2026 10:49:15 +0900 [thread overview]
Message-ID: <6c9f7828-daf4-4770-b9c0-02efdf22c97b@kernel.org> (raw)
In-Reply-To: <20260725015209.1207666-1-rdunlap@infradead.org>
On 7/25/26 10:52, Randy Dunlap wrote:
> Modify comments to prevent kernel-doc warnings:
> - use "/*" for a non-kernel-doc comment
> - add a Returns: section for ata_id_major_version()
>
> Warning: include/linux/ata.h:770 Cannot find identifier on line:
> *
> Warning: include/linux/ata.h:782 function parameter 'id' not described in 'ata_id_sct_data_tables'
> Warning: include/linux/ata.h:782 expecting prototype for Word(). Prototype was for ata_id_sct_data_tables() instead
> Warning: include/linux/ata.h:820 No description found for return value of 'ata_id_major_version'
>
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Applied to for-7.2-fixes with the comment tweak we discussed. Thanks!
--
Damien Le Moal
Western Digital Research
prev parent reply other threads:[~2026-07-27 1:49 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-07-25 1:52 Randy Dunlap
2026-07-26 2:49 ` Damien Le Moal
2026-07-26 3:41 ` Randy Dunlap
2026-07-26 4:14 ` Damien Le Moal
2026-07-26 4:19 ` Randy Dunlap
2026-07-27 2:02 ` Damien Le Moal
2026-07-27 1:49 ` Damien Le Moal [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=6c9f7828-daf4-4770-b9c0-02efdf22c97b@kernel.org \
--to=dlemoal@kernel.org \
--cc=cassel@kernel.org \
--cc=linux-ide@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=rdunlap@infradead.org \
/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
all inboxes | Powered by JetHome®