device property: Clarify description of returned value in some functions
authorAndy Shevchenko <andriy.shevchenko@linux.intel.com>
Fri, 17 Feb 2023 13:33:44 +0000 (15:33 +0200)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Fri, 10 Mar 2023 08:06:22 +0000 (09:06 +0100)
commit295209ca7b5b3aa6375d6190311b2ae804dbcf65
tree27b3fe7fb66291901995c4d6c0bd5aa0ea3387d3
parentf8fb576658a3e19796e2e1a12a5ec8f44dac02b6
device property: Clarify description of returned value in some functions

Some of the functions do not provide Return: section on absence of which
kernel-doc complains. Besides that several functions return the fwnode
handle with incremented reference count. Add a respective note to make sure
that the caller decrements it when it's not needed anymore.

While at it, unify the style of the Return: sections.

Reported-by: Daniel Kaehn <kaehndan@gmail.com>
Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Acked-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Acked-by: Rafael J. Wysocki <rafael@kernel.org>
Link: https://lore.kernel.org/r/20230217133344.79278-1-andriy.shevchenko@linux.intel.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
drivers/base/property.c