Commit 5f94e9c8 authored Sep 22, 2020 by Xiaofei Tan Committed by Jiri Kosina Sep 23, 2020

HID: core: fix kerneldoc warnings in hid-core.c

Fix following warnings caused by mismatch bewteen function parameters
and comments.
drivers/hid/hid-core.c:931: warning: Function parameter or member 'hid' not described in 'hid_parse_report'
drivers/hid/hid-core.c:931: warning: Excess function parameter 'device' description in 'hid_parse_report'
drivers/hid/hid-core.c:961: warning: Function parameter or member 'hid' not described in 'hid_validate_values'
drivers/hid/hid-core.c:961: warning: Excess function parameter 'device' description in 'hid_validate_values'
drivers/hid/hid-core.c:1452: warning: Function parameter or member 'report' not described in 'hid_match_report'
drivers/hid/hid-core.c:1452: warning: Excess function parameter 'report_type' description in 'hid_match_report'
drivers/hid/hid-core.c:2132: warning: Function parameter or member 'drv' not described in 'new_id_store'
drivers/hid/hid-core.c:2132: warning: Excess function parameter 'driver' description in 'new_id_store'

Signed-off-by: Xiaofei Tan <tanxiaofei@huawei.com>
Signed-off-by: Jiri Kosina <jkosina@suse.cz>

parent 4a6a4c96

drivers/hid/hid-core.c

+4 −4

Original line number	Diff line number	Diff line
		@@ -920,7 +920,7 @@ static int hid_scan_report(struct hid_device *hid)
		/**
		* hid_parse_report - parse device report
		*
		* @device: hid device
		* @hid: hid device
		* @start: report start
		* @size: report size
		*
		@@ -945,7 +945,7 @@ static const char * const hid_report_names[] = {
		/**
		* hid_validate_values - validate existing device report's value indexes
		*
		* @device: hid device
		* @hid: hid device
		* @type: which report type to examine
		* @id: which report ID to examine (0 for first)
		* @field_index: which report field to examine
		@@ -1444,7 +1444,7 @@ static int search(__s32 *array, __s32 value, unsigned n)
		* hid_match_report - check if driver's raw_event should be called
		*
		* @hid: hid device
		* @report_type: type to match against
		* @report: hid report to match against
		*
		* compare hid->driver->report_table->report_type to report->type
		*/
		@@ -2120,7 +2120,7 @@ struct hid_dynid {

		/**
		* store_new_id - add a new HID device ID to this driver and re-probe devices
		* @driver: target device driver
		* @drv: target device driver
		* @buf: buffer for scanning device ID data
		* @count: input size
		*

Admin message