Re: [PATCH] gpio: nomadik: repair some kernel-doc comments
From: Bartosz Golaszewski
Date: Mon Mar 02 2026 - 04:42:53 EST
On Sat, 28 Feb 2026 17:48:11 -0800, Randy Dunlap wrote:
> Avoid these kernel-doc warnings by:
> - adding short descriptions for enums
> - using correct (matching) struct names in kernel-doc short descriptions
> - using the correct struct member name for @nfunctions
>
> Warning: include/linux/gpio/gpio-nomadik.h:116 missing initial short
> description on line: * enum prcm_gpiocr_reg_index
> Warning: include/linux/gpio/gpio-nomadik.h:125 missing initial short
> description on line: * enum prcm_gpiocr_altcx_index
> Warning: include/linux/gpio/gpio-nomadik.h:146 expecting prototype for
> struct prcm_gpio_altcx. Prototype was for struct prcm_gpiocr_altcx instead
> Warning: include/linux/gpio/gpio-nomadik.h:156 expecting prototype for
> struct prcm_gpio_altcx_pin_desc. Prototype was for
> struct prcm_gpiocr_altcx_pin_desc instead
> Warning: include/linux/gpio/gpio-nomadik.h:212 struct member 'nfunctions'
> not described in 'nmk_pinctrl_soc_data'
>
> [...]
Randy: please use scripts/get_maintainer.pl or b4. I don't always go through
all the patches on the mailing list - I expect to be Cc'ed explicitly.
Queued for fixes.
[1/1] gpio: nomadik: repair some kernel-doc comments
https://git.kernel.org/brgl/c/189645ba9cd9c1eed45151aacaae4347c1eb86a7
Best regards,
--
Bartosz Golaszewski <bartosz.golaszewski@xxxxxxxxxxxxxxxx>