linux-gpio.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [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).