tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

gpio: nomadik: repair some kernel-doc comments

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'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Link: https://patch.msgid.link/20260301014811.3133250-1-rdunlap@infradead.org
Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@oss.qualcomm.com>

authored by

Randy Dunlap and committed by
Bartosz Golaszewski 189645ba 8a9ebe8c

+5 -7
+5 -7
include/linux/gpio/gpio-nomadik.h
··· 114 114 } 115 115 116 116 /** 117 - * enum prcm_gpiocr_reg_index 118 - * Used to reference an PRCM GPIOCR register address. 117 + * enum prcm_gpiocr_reg_index - Used to reference a PRCM GPIOCR register address. 119 118 */ 120 119 enum prcm_gpiocr_reg_index { 121 120 PRCM_IDX_GPIOCR1, ··· 122 123 PRCM_IDX_GPIOCR3 123 124 }; 124 125 /** 125 - * enum prcm_gpiocr_altcx_index 126 - * Used to reference an Other alternate-C function. 126 + * enum prcm_gpiocr_altcx_index - Used to reference an Other alternate-C function. 127 127 */ 128 128 enum prcm_gpiocr_altcx_index { 129 129 PRCM_IDX_GPIOCR_ALTC1, ··· 133 135 }; 134 136 135 137 /** 136 - * struct prcm_gpio_altcx - Other alternate-C function 138 + * struct prcm_gpiocr_altcx - Other alternate-C function 137 139 * @used: other alternate-C function availability 138 140 * @reg_index: PRCM GPIOCR register index used to control the function 139 141 * @control_bit: PRCM GPIOCR bit used to control the function ··· 145 147 } __packed; 146 148 147 149 /** 148 - * struct prcm_gpio_altcx_pin_desc - Other alternate-C pin 150 + * struct prcm_gpiocr_altcx_pin_desc - Other alternate-C pin 149 151 * @pin: The pin number 150 152 * @altcx: array of other alternate-C[1-4] functions 151 153 */ ··· 191 193 * numbering. 192 194 * @npins: The number of entries in @pins. 193 195 * @functions: The functions supported on this SoC. 194 - * @nfunction: The number of entries in @functions. 196 + * @nfunctions: The number of entries in @functions. 195 197 * @groups: An array describing all pin groups the pin SoC supports. 196 198 * @ngroups: The number of entries in @groups. 197 199 * @altcx_pins: The pins that support Other alternate-C function on this SoC