gpiolib: Discourage to use formatting strings in line names
authorAndy Shevchenko <andy.shevchenko@gmail.com>
Sun, 5 May 2024 14:14:20 +0000 (17:14 +0300)
committerBartosz Golaszewski <bartosz.golaszewski@linaro.org>
Tue, 7 May 2024 07:43:17 +0000 (09:43 +0200)
commit2b5ae9c7d9e5ef4bc52c932fdf10328feb5167c6
treeaa9e417aeaf848563a8c69919f6f1e6483c548ef
parent68a25c36718e480277b487ae286553c177988a1a
gpiolib: Discourage to use formatting strings in line names

Currently the documentation for line names allows to use %u inside
the alternative name. This is broken in character device approach
from day 1 and being in use solely in sysfs.

Character device interface has a line number as a part of its address,
so the users better rely on it. Hence remove the misleading documentation.

On top of that, there are no in-kernel users (out of 6, if I'm correct)
for such names and moreover if one exists it won't help in distinguishing
lines with the same naming as '%u' will also be in them and we will get
a warning in gpiochip_set_desc_names() for such cases.

Signed-off-by: Andy Shevchenko <andy.shevchenko@gmail.com>
Reviewed-by: Linus Walleij <linus.walleij@linaro.org>
Reviewed-by: Kent Gibson <warthog618@gmail.com>
Link: https://lore.kernel.org/r/20240505141420.627398-1-andy.shevchenko@gmail.com
Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
include/linux/gpio/driver.h