Re: [PATCH] firewire: init_ohci1394_dma: add missing function parameter documentation

From: Takashi Sakamoto
Date: Fri Oct 24 2025 - 19:34:41 EST


On Sat, Oct 25, 2025 at 02:02:19AM +0530, Nirbhay Sharma wrote:
> Add missing kernel-doc parameter descriptions for five functions
> in init_ohci1394_dma.c to fix documentation warnings when building
> with W=1.
>
> This patch addresses the following warnings:
> - init_ohci1394_wait_for_busresets: missing @ohci description
> - init_ohci1394_enable_physical_dma: missing @ohci description
> - init_ohci1394_reset_and_init_dma: missing @ohci description
> - init_ohci1394_controller: missing @num, @slot, @func descriptions
> - setup_ohci1394_dma: missing @opt description
>
> Tested with GCC 13.2.0 and W=1 flag. All documentation warnings
> for these functions have been resolved.
>
> Signed-off-by: Nirbhay Sharma <nirbhay.lkd@xxxxxxxxx>
> ---
> drivers/firewire/init_ohci1394_dma.c | 10 ++++++++++
> 1 file changed, 10 insertions(+)

Applied to for-linus branch.


Thanks

Takashi Sakamoto