Thread (9 messages) 9 messages, 4 authors, 2021-05-20

Re: [PATCH v2 1/1] gpiolib: Introduce for_each_gpio_desc_if() macro

From: Johan Hovold <johan@kernel.org>
Date: 2021-05-20 10:12:30
Also in: lkml

On Thu, May 20, 2021 at 12:16:20PM +0300, Andy Shevchenko wrote:
On Thu, May 20, 2021 at 10:33:38AM +0200, Johan Hovold wrote:
quoted
On Thu, May 20, 2021 at 11:15:31AM +0300, Andy Shevchenko wrote:
quoted
On Thu, May 20, 2021 at 11:07 AM Johan Hovold [off-list ref] wrote:
quoted
On Tue, May 18, 2021 at 11:33:39AM +0300, Andy Shevchenko wrote:
quoted
quoted
The _if suffix here is too vague.

Please use a more descriptive name so that you don't need to look at the
implementation to understand what the macro does.

Perhaps call it

        for_each_gpio_desc_with_flag()
quoted
quoted
quoted
or just add the more generic macro

        for_each_gpio_desc()

and open-code the test so that it's clear what's going on here.
FWIW, NAK due to the non-descriptive for_each_desc_if() name.
Btw, missed argument

..._with_flag(..., FLAG_...)

breaks the DRY principle. If you read current code it's clear with that

_if(..., FLAG_...)
That we have precisely zero for_each_ macros with an _if suffix should
also give you a hint that this is not a good idea.

Again, you shouldn't have to look at the implementation to understand
what a helper does.

Johan
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help