kernel-doc: fix new warnings in device.h
PATCH 6/14 kernel-doc: fix new warnings in device.h
From: Randy Dunlap <[email protected]>
Fix new kernel-doc warnings:
Warning(include/linux/device.h:299): No description found for parameter 'name' Warning(include/linux/device.h:299): No description found for parameter 'subsys' Warning(include/linux/device.h:299): No description found for parameter 'node' Warning(include/linux/device.h:299): No description found for parameter 'add_dev' Warning(include/linux/device.h:299): No description found for parameter 'remove_dev' Warning(include/linux/device.h:685): No description found for parameter 'id' Warning(include/linux/device.h:1009): No description found for parameter '__driver' Warning(include/linux/device.h:1009): No description found for parameter '__register' Warning(include/linux/device.h:1009): No description found for parameter '__unregister'
--- include/linux/device.h | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-)
include/linux/device.h +10 -5
@@ -279,11 +279,11 @@ struct device *driver_find_device(struct/** * struct subsys_interface - interfaces to device functions -* @name name of the device function -* @subsystem subsytem of the devices to attach to -* @node the list of functions registered at the subsystem -* @add device hookup to device function handler -* @remove device hookup to device function handler +* @name: name of the device function +* @subsys: subsytem of the devices to attach to +* @node: the list of functions registered at the subsystem +* @add_dev: device hookup to device function handler +* @remove_dev: device hookup to device function handler * * Simple interfaces attached to a subsystem. Multiple interfaces can * attach to a subsystem and its devices. Unlike drivers, they do not
@@ -612,6 +612,7 @@ struct device_dma_parameters {* @archdata: For arch-specific additions. * @of_node: Associated device tree node. * @devt: For creating the sysfs "dev". +* @id: device instance * @devres_lock: Spinlock to protect the resource of the device. * @devres_head: The resources list of the device. * @knode_class: The node used to add the device to the class list.
@@ -1003,6 +1004,10 @@ extern long sysfs_deprecated;* Each module may only use this macro once, and calling it replaces * module_init() and module_exit(). * +* @__driver: driver name +* @__register: register function for this driver type +* @__unregister: unregister function for this driver type +* * Use this macro to construct bus specific macros for registering * drivers, and do not use it on its own. */