]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
firewire: init_ohci1394_dma: add missing function parameter documentation
authorNirbhay Sharma <nirbhay.lkd@gmail.com>
Fri, 24 Oct 2025 20:32:19 +0000 (02:02 +0530)
committerTakashi Sakamoto <o-takashi@sakamocchi.jp>
Fri, 24 Oct 2025 23:29:56 +0000 (08:29 +0900)
commit73ba88fb04081372a69f0395958ac6b65d53d134
tree9d69bba8bf5abde872385ede353bb1484e9f5bbf
parent246aca5b2a2c4ad3e75c2eff616f5532019a92d2
firewire: init_ohci1394_dma: add missing function parameter documentation

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@gmail.com>
Link: https://lore.kernel.org/r/20251024203219.101990-2-nirbhay.lkd@gmail.com
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>
drivers/firewire/init_ohci1394_dma.c