driver core: Add missing parameter description to __fwnode_link_add()

andy-shev · gregkh · commit f1ac370cdda3 · 2023-10-05T13:11:35.000+02:00
The kernel documentation validator is not happy with: drivers/base/core.c:67: warning: Function parameter or member 'flags' not described in '__fwnode_link_add' Add missing parameter description. Fixes: 6a6dfdf ("driver core: fw_devlink: Allow marking a fwnode link as being part of a cycle") Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com> Link: https://lore.kernel.org/r/20230919195048.3197551-1-andriy.shevchenko@linux.intel.com Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
diff --git a/drivers/base/core.c b/drivers/base/core.c
@@ -49,6 +49,7 @@ static bool fw_devlink_best_effort;
  * __fwnode_link_add - Create a link between two fwnode_handles.
  * @con: Consumer end of the link.
  * @sup: Supplier end of the link.
+ * @flags: Link flags.
  *
  * Create a fwnode link between fwnode handles @con and @sup. The fwnode link
  * represents the detail that the firmware lists @sup fwnode as supplying a

Original file line number	Diff line number	Diff line change
`@@ -49,6 +49,7 @@ static bool fw_devlink_best_effort;`
`49`	`49`	`* __fwnode_link_add - Create a link between two fwnode_handles.`
`50`	`50`	`* @con: Consumer end of the link.`
`51`	`51`	`* @sup: Supplier end of the link.`
	`52`	`+ * @flags: Link flags.`
`52`	`53`	`*`
`53`	`54`	`* Create a fwnode link between fwnode handles @con and @sup. The fwnode link`
`54`	`55`	`* represents the detail that the firmware lists @sup fwnode as supplying a`