ata: libata: avoid kernel-doc warnings
authorRandy Dunlap <rdunlap@infradead.org>
Sat, 25 Jul 2026 01:52:09 +0000 (18:52 -0700)
committerDamien Le Moal <dlemoal@kernel.org>
Tue, 28 Jul 2026 03:04:17 +0000 (12:04 +0900)
commitaec49a34d928a0ecdea85bd9f6b4114b668b68b8
tree097aa7039cf7bf260fbce2813c0f059d3a20c5e0
parent4d99a91574c420decab56cc880fad0dc15b8a7a3
ata: libata: avoid kernel-doc warnings

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>
Signed-off-by: Damien Le Moal <dlemoal@kernel.org>
include/linux/ata.h