* [PATCH] pinctrl: renesas: rza1: Fix kerneldoc function names
@ 2021-10-19 12:34 Geert Uytterhoeven
2021-10-19 12:43 ` Jacopo Mondi
0 siblings, 1 reply; 4+ messages in thread
From: Geert Uytterhoeven @ 2021-10-19 12:34 UTC (permalink / raw)
To: Linus Walleij, Jacopo Mondi
Cc: linux-renesas-soc, linux-gpio, Geert Uytterhoeven
make W=1:
drivers/pinctrl/renesas/pinctrl-rza1.c:770: warning: expecting prototype for rza1_gpio_disable_free(). Prototype was for rza1_gpio_free() instead
drivers/pinctrl/renesas/pinctrl-rza1.c:889: warning: expecting prototype for rza1_parse_pmx_function(). Prototype was for rza1_parse_pinmux_node() instead
Fixes: 5a49b644b3075f88 ("pinctrl: Renesas RZ/A1 pin and gpio controller")
Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be>
---
To be queued in renesas-pinctrl for v5.17.
drivers/pinctrl/renesas/pinctrl-rza1.c | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/drivers/pinctrl/renesas/pinctrl-rza1.c b/drivers/pinctrl/renesas/pinctrl-rza1.c
index 10020fe302b8a09f..3ad0537febe4f6b4 100644
--- a/drivers/pinctrl/renesas/pinctrl-rza1.c
+++ b/drivers/pinctrl/renesas/pinctrl-rza1.c
@@ -757,7 +757,7 @@ static int rza1_gpio_request(struct gpio_chip *chip, unsigned int gpio)
}
/**
- * rza1_gpio_disable_free() - reset a pin
+ * rza1_gpio_free() - reset a pin
*
* Surprisingly, disable_free a gpio, is equivalent to request it.
* Reset pin to port mode, with input buffer disabled. This overwrites all
@@ -875,7 +875,7 @@ static int rza1_dt_node_pin_count(struct device_node *np)
}
/**
- * rza1_parse_pmx_function() - parse a pin mux sub-node
+ * rza1_parse_pinmux_node() - parse a pin mux sub-node
*
* @rza1_pctl: RZ/A1 pin controller device
* @np: of pmx sub-node
--
2.25.1
^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [PATCH] pinctrl: renesas: rza1: Fix kerneldoc function names
2021-10-19 12:34 [PATCH] pinctrl: renesas: rza1: Fix kerneldoc function names Geert Uytterhoeven
@ 2021-10-19 12:43 ` Jacopo Mondi
2021-10-19 12:54 ` Geert Uytterhoeven
0 siblings, 1 reply; 4+ messages in thread
From: Jacopo Mondi @ 2021-10-19 12:43 UTC (permalink / raw)
To: Geert Uytterhoeven
Cc: Linus Walleij, Jacopo Mondi, linux-renesas-soc, linux-gpio
Hi Geert,
On Tue, Oct 19, 2021 at 02:34:22PM +0200, Geert Uytterhoeven wrote:
> make W=1:
>
> drivers/pinctrl/renesas/pinctrl-rza1.c:770: warning: expecting prototype for rza1_gpio_disable_free(). Prototype was for rza1_gpio_free() instead
> drivers/pinctrl/renesas/pinctrl-rza1.c:889: warning: expecting prototype for rza1_parse_pmx_function(). Prototype was for rza1_parse_pinmux_node() instead
>
> Fixes: 5a49b644b3075f88 ("pinctrl: Renesas RZ/A1 pin and gpio controller")
> Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be>
Thanks, looking at the driver now it seems I was really eager to write
comments at the time I wrote it! :)
Probably all kernel-doc comments should be demoted to regular
comments, as they're only internal driver functions.
But for now, the change is good
> ---
> To be queued in renesas-pinctrl for v5.17.
>
> drivers/pinctrl/renesas/pinctrl-rza1.c | 4 ++--
> 1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/drivers/pinctrl/renesas/pinctrl-rza1.c b/drivers/pinctrl/renesas/pinctrl-rza1.c
> index 10020fe302b8a09f..3ad0537febe4f6b4 100644
> --- a/drivers/pinctrl/renesas/pinctrl-rza1.c
> +++ b/drivers/pinctrl/renesas/pinctrl-rza1.c
> @@ -757,7 +757,7 @@ static int rza1_gpio_request(struct gpio_chip *chip, unsigned int gpio)
> }
>
> /**
> - * rza1_gpio_disable_free() - reset a pin
> + * rza1_gpio_free() - reset a pin
> *
> * Surprisingly, disable_free a gpio, is equivalent to request it.
s/disable_free/free ?
Reviewed-by: Jacopo Mondi <jacopo+renesas@jmondi.org>
Thanks
j
> * Reset pin to port mode, with input buffer disabled. This overwrites all
> @@ -875,7 +875,7 @@ static int rza1_dt_node_pin_count(struct device_node *np)
> }
>
> /**
> - * rza1_parse_pmx_function() - parse a pin mux sub-node
> + * rza1_parse_pinmux_node() - parse a pin mux sub-node
> *
> * @rza1_pctl: RZ/A1 pin controller device
> * @np: of pmx sub-node
> --
> 2.25.1
>
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] pinctrl: renesas: rza1: Fix kerneldoc function names
2021-10-19 12:43 ` Jacopo Mondi
@ 2021-10-19 12:54 ` Geert Uytterhoeven
2021-10-26 7:35 ` Geert Uytterhoeven
0 siblings, 1 reply; 4+ messages in thread
From: Geert Uytterhoeven @ 2021-10-19 12:54 UTC (permalink / raw)
To: Jacopo Mondi
Cc: Linus Walleij, Jacopo Mondi, Linux-Renesas,
open list:GPIO SUBSYSTEM
Hi Jacopo,
On Tue, Oct 19, 2021 at 2:42 PM Jacopo Mondi <jacopo@jmondi.org> wrote:
> On Tue, Oct 19, 2021 at 02:34:22PM +0200, Geert Uytterhoeven wrote:
> > make W=1:
> >
> > drivers/pinctrl/renesas/pinctrl-rza1.c:770: warning: expecting prototype for rza1_gpio_disable_free(). Prototype was for rza1_gpio_free() instead
> > drivers/pinctrl/renesas/pinctrl-rza1.c:889: warning: expecting prototype for rza1_parse_pmx_function(). Prototype was for rza1_parse_pinmux_node() instead
> >
> > Fixes: 5a49b644b3075f88 ("pinctrl: Renesas RZ/A1 pin and gpio controller")
> > Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be>
>
> Thanks, looking at the driver now it seems I was really eager to write
> comments at the time I wrote it! :)
>
> Probably all kernel-doc comments should be demoted to regular
> comments, as they're only internal driver functions.
;-)
> > --- a/drivers/pinctrl/renesas/pinctrl-rza1.c
> > +++ b/drivers/pinctrl/renesas/pinctrl-rza1.c
> > @@ -757,7 +757,7 @@ static int rza1_gpio_request(struct gpio_chip *chip, unsigned int gpio)
> > }
> >
> > /**
> > - * rza1_gpio_disable_free() - reset a pin
> > + * rza1_gpio_free() - reset a pin
> > *
> > * Surprisingly, disable_free a gpio, is equivalent to request it.
>
> s/disable_free/free ?
Yup, will fix while applying to:
disabling a gpio is equivalent to requesting it
> Reviewed-by: Jacopo Mondi <jacopo+renesas@jmondi.org>
Thanks!
Gr{oetje,eeting}s,
Geert
--
Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- geert@linux-m68k.org
In personal conversations with technical people, I call myself a hacker. But
when I'm talking to journalists I just say "programmer" or something like that.
-- Linus Torvalds
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] pinctrl: renesas: rza1: Fix kerneldoc function names
2021-10-19 12:54 ` Geert Uytterhoeven
@ 2021-10-26 7:35 ` Geert Uytterhoeven
0 siblings, 0 replies; 4+ messages in thread
From: Geert Uytterhoeven @ 2021-10-26 7:35 UTC (permalink / raw)
To: Jacopo Mondi
Cc: Linus Walleij, Jacopo Mondi, Linux-Renesas,
open list:GPIO SUBSYSTEM
On Tue, Oct 19, 2021 at 2:54 PM Geert Uytterhoeven <geert@linux-m68k.org> wrote:
> On Tue, Oct 19, 2021 at 2:42 PM Jacopo Mondi <jacopo@jmondi.org> wrote:
> > On Tue, Oct 19, 2021 at 02:34:22PM +0200, Geert Uytterhoeven wrote:
> > > --- a/drivers/pinctrl/renesas/pinctrl-rza1.c
> > > +++ b/drivers/pinctrl/renesas/pinctrl-rza1.c
> > > @@ -757,7 +757,7 @@ static int rza1_gpio_request(struct gpio_chip *chip, unsigned int gpio)
> > > }
> > >
> > > /**
> > > - * rza1_gpio_disable_free() - reset a pin
> > > + * rza1_gpio_free() - reset a pin
> > > *
> > > * Surprisingly, disable_free a gpio, is equivalent to request it.
> >
> > s/disable_free/free ?
>
> Yup, will fix while applying to:
>
> disabling a gpio is equivalent to requesting it
"freeing...", of course.
Gr{oetje,eeting}s,
Geert
--
Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- geert@linux-m68k.org
In personal conversations with technical people, I call myself a hacker. But
when I'm talking to journalists I just say "programmer" or something like that.
-- Linus Torvalds
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2021-10-26 7:36 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2021-10-19 12:34 [PATCH] pinctrl: renesas: rza1: Fix kerneldoc function names Geert Uytterhoeven
2021-10-19 12:43 ` Jacopo Mondi
2021-10-19 12:54 ` Geert Uytterhoeven
2021-10-26 7:35 ` Geert Uytterhoeven
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).