Re: [PATCH] ata: libata: avoid kernel-doc warnings

Damien Le Moal <[email protected]> Mon, 27 Jul 2026 10:49:15 +0900

Newsgroups	org.kernel.vger.linux-ide,org.kernel.vger.linux-kernel
Organization	Western Digital Research
Message-ID	<[email protected]>

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 <[email protected]>

Applied to for-7.2-fixes with the comment tweak we discussed. Thanks!

-- 
Damien Le Moal
Western Digital Research