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

pinctrl: bcm: pinctrl-bcm281xx: Demote obvious misuse of kerneldoc to standard comment blocks

There has been little to no attempt to document any of the demoted
structures here. These are obviously not kerneldoc headers.

Fixes the following W=1 kernel build warning(s):

drivers/pinctrl/bcm/pinctrl-bcm281xx.c:65: warning: cannot understand function prototype: 'enum bcm281xx_pin_type '
drivers/pinctrl/bcm/pinctrl-bcm281xx.c:79: warning: cannot understand function prototype: 'struct bcm281xx_pin_function '
drivers/pinctrl/bcm/pinctrl-bcm281xx.c:89: warning: cannot understand function prototype: 'struct bcm281xx_pinctrl_data '

Signed-off-by: Lee Jones <lee.jones@linaro.org>
Acked-by: Scott Branden <scott.branden@broadcom.com>
Cc: Florian Fainelli <f.fainelli@gmail.com>
Cc: Ray Jui <rjui@broadcom.com>
Cc: Scott Branden <sbranden@broadcom.com>
Cc: bcm-kernel-feedback-list@broadcom.com
Cc: YueHaibing <yuehaibing@huawei.com>
Link: https://lore.kernel.org/r/20200713144930.1034632-4-lee.jones@linaro.org
Signed-off-by: Linus Walleij <linus.walleij@linaro.org>

authored by

Lee Jones and committed by
Linus Walleij
1294754e bef63e66

+3 -3
+3 -3
drivers/pinctrl/bcm/pinctrl-bcm281xx.c
··· 59 59 #define BCM281XX_HDMI_PIN_REG_MODE_MASK 0x0010 60 60 #define BCM281XX_HDMI_PIN_REG_MODE_SHIFT 4 61 61 62 - /** 62 + /* 63 63 * bcm281xx_pin_type - types of pin register 64 64 */ 65 65 enum bcm281xx_pin_type { ··· 73 73 static enum bcm281xx_pin_type i2c_pin = BCM281XX_PIN_TYPE_I2C; 74 74 static enum bcm281xx_pin_type hdmi_pin = BCM281XX_PIN_TYPE_HDMI; 75 75 76 - /** 76 + /* 77 77 * bcm281xx_pin_function- define pin function 78 78 */ 79 79 struct bcm281xx_pin_function { ··· 82 82 const unsigned ngroups; 83 83 }; 84 84 85 - /** 85 + /* 86 86 * bcm281xx_pinctrl_data - Broadcom-specific pinctrl data 87 87 * @reg_base - base of pinctrl registers 88 88 */