[PATCH] gpio: regmap: fix kernel-doc notation

[PATCH] gpio: regmap: fix kernel-doc notation

[Randy Dunlap]

Add a ':' to the end of struct member names to prevent kernel-doc
warnings:

Warning: include/linux/gpio/regmap.h:108 struct member 'regmap_irq_line'
 not described in 'gpio_regmap_config'
Warning: include/linux/gpio/regmap.h:108 struct member 'regmap_irq_flags'
 not described in 'gpio_regmap_config'

Fixes: 553b75d4bfe9 ("gpio: regmap: Allow to allocate regmap-irq device")
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
Cc: Michael Walle <mwalle@kernel.org>
Cc: Linus Walleij <linus.walleij@linaro.org>
Cc: Bartosz Golaszewski <brgl@kernel.org>
Cc: linux-gpio@vger.kernel.org
Cc: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Cc: Mathieu Dubois-Briand <mathieu.dubois-briand@bootlin.com>
Cc: Lee Jones <lee@kernel.org>
Cc: Mark Brown <broonie@kernel.org>
---
 include/linux/gpio/regmap.h |    4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

--- linux-next-20251127.orig/include/linux/gpio/regmap.h
+++ linux-next-20251127/include/linux/gpio/regmap.h
@@ -50,8 +50,8 @@ struct regmap;
  * @regmap_irq_chip:	(Optional) Pointer on an regmap_irq_chip structure. If
  *			set, a regmap-irq device will be created and the IRQ
  *			domain will be set accordingly.
- * @regmap_irq_line	(Optional) The IRQ the device uses to signal interrupts.
- * @regmap_irq_flags	(Optional) The IRQF_ flags to use for the interrupt.
+ * @regmap_irq_line:	(Optional) The IRQ the device uses to signal interrupts.
+ * @regmap_irq_flags:	(Optional) The IRQF_ flags to use for the interrupt.
  *
  * The ->reg_mask_xlate translates a given base address and GPIO offset to
  * register and mask pair. The base address is one of the given register

Re: [PATCH] gpio: regmap: fix kernel-doc notation

[Andy Shevchenko]

On Thu, Nov 27, 2025 at 10:27:39PM -0800, Randy Dunlap wrote:
> Add a ':' to the end of struct member names to prevent kernel-doc
> warnings:
> 
> Warning: include/linux/gpio/regmap.h:108 struct member 'regmap_irq_line'
>  not described in 'gpio_regmap_config'
> Warning: include/linux/gpio/regmap.h:108 struct member 'regmap_irq_flags'
>  not described in 'gpio_regmap_config'

Reviewed-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Thanks!

-- 
With Best Regards,
Andy Shevchenko

Re: [PATCH] gpio: regmap: fix kernel-doc notation

[Michael Walle]

[-- Attachment #1: Type: text/plain, Size: 576 bytes --]

On Fri Nov 28, 2025 at 7:27 AM CET, Randy Dunlap wrote:
> Add a ':' to the end of struct member names to prevent kernel-doc
> warnings:
>
> Warning: include/linux/gpio/regmap.h:108 struct member 'regmap_irq_line'
>  not described in 'gpio_regmap_config'
> Warning: include/linux/gpio/regmap.h:108 struct member 'regmap_irq_flags'
>  not described in 'gpio_regmap_config'
>
> Fixes: 553b75d4bfe9 ("gpio: regmap: Allow to allocate regmap-irq device")
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>

Reviewed-by: Michael Walle <mwalle@kernel.org>

-michael

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 297 bytes --]

Re: [PATCH] gpio: regmap: fix kernel-doc notation

[Bartosz Golaszewski]

From: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>


On Thu, 27 Nov 2025 22:27:39 -0800, Randy Dunlap wrote:
> Add a ':' to the end of struct member names to prevent kernel-doc
> warnings:
> 
> Warning: include/linux/gpio/regmap.h:108 struct member 'regmap_irq_line'
>  not described in 'gpio_regmap_config'
> Warning: include/linux/gpio/regmap.h:108 struct member 'regmap_irq_flags'
>  not described in 'gpio_regmap_config'
> 
> [...]

Applied, thanks!

[1/1] gpio: regmap: fix kernel-doc notation
      https://git.kernel.org/brgl/linux/c/f01c0f7ee59fce16e5bae92a2d388a8a6fdf3f0f

Best regards,
-- 
Bartosz Golaszewski <bartosz.golaszewski@linaro.org>