Commit 716cec5f authored by Gil Fine's avatar Gil Fine Committed by Greg Kroah-Hartman
Browse files

driver core: Fix order of the kernel-doc parameters 



Fix the order of the kernel-doc parameters in device_find_child() and
device_for_each_child*() functions to match the actual functions signature.

No functional changes.

Signed-off-by: default avatarGil Fine <gil.fine@linux.intel.com>
Link: https://lore.kernel.org/r/20250831194930.2063390-1-gil.fine@linux.intel.com


Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent a86537ad

drivers/base/core.c

+4 −4
Original line number Diff line number Diff line
@@ -3994,8 +3994,8 @@ const char *device_get_devnode(const struct device *dev, 
/**

 * device_for_each_child - device child iterator.

 * @parent: parent struct device.

 * @fn: function to be called for each device.

 * @data: data for the callback.

 * @fn: function to be called for each device.

 *

 * Iterate over @parent's child devices, and call @fn for each,

 * passing it @data.
@@ -4024,8 +4024,8 @@ EXPORT_SYMBOL_GPL(device_for_each_child); 
/**

 * device_for_each_child_reverse - device child iterator in reversed order.

 * @parent: parent struct device.

 * @fn: function to be called for each device.

 * @data: data for the callback.

 * @fn: function to be called for each device.

 *

 * Iterate over @parent's child devices, and call @fn for each,

 * passing it @data.
@@ -4055,8 +4055,8 @@ EXPORT_SYMBOL_GPL(device_for_each_child_reverse); 
 * device_for_each_child_reverse_from - device child iterator in reversed order.

 * @parent: parent struct device.

 * @from: optional starting point in child list

 * @fn: function to be called for each device.

 * @data: data for the callback.

 * @fn: function to be called for each device.

 *

 * Iterate over @parent's child devices, starting at @from, and call @fn

 * for each, passing it @data. This helper is identical to
@@ -4089,8 +4089,8 @@ EXPORT_SYMBOL_GPL(device_for_each_child_reverse_from); 
/**

 * device_find_child - device iterator for locating a particular device.

 * @parent: parent struct device

 * @match: Callback function to check device

 * @data: Data to pass to match function

 * @match: Callback function to check device

 *

 * This is similar to the device_for_each_child() function above, but it

 * returns a reference to a device that is 'found' for later use, as