Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

firmware: arm_scmi: Fix kernel doc warnings about return values

Kernel doc validation script still complains about the following:

|No description found for return value of 'scmi_get_protocol_device'
|No description found for return value of 'scmi_devm_notifier_register'
|No description found for return value of 'scmi_devm_notifier_unregister'

Fix adding missing Return kernel-doc statements.

Link: https://lore.kernel.org/r/20210712143504.33541-1-cristian.marussi@arm.com
Signed-off-by: Cristian Marussi <cristian.marussi@arm.com>
Signed-off-by: Sudeep Holla <sudeep.holla@arm.com>

authored by

Cristian Marussi and committed by
Sudeep Holla
b98cf55e 5ff6319d

+6
+2
drivers/firmware/arm_scmi/driver.c
··· 1138 1138 * @proto_id and @name: if device was still not existent it is created as a 1139 1139 * child of the specified SCMI instance @info and its transport properly 1140 1140 * initialized as usual. 1141 + * 1142 + * Return: A properly initialized scmi device, NULL otherwise. 1141 1143 */ 1142 1144 static inline struct scmi_device * 1143 1145 scmi_get_protocol_device(struct device_node *np, struct scmi_info *info,
+4
drivers/firmware/arm_scmi/notify.c
··· 1457 1457 * 1458 1458 * Generic devres managed helper to register a notifier_block against a 1459 1459 * protocol event. 1460 + * 1461 + * Return: 0 on Success 1460 1462 */ 1461 1463 static int scmi_devm_notifier_register(struct scmi_device *sdev, 1462 1464 u8 proto_id, u8 evt_id, ··· 1525 1523 * Generic devres managed helper to explicitly un-register a notifier_block 1526 1524 * against a protocol event, which was previously registered using the above 1527 1525 * @scmi_devm_notifier_register. 1526 + * 1527 + * Return: 0 on Success 1528 1528 */ 1529 1529 static int scmi_devm_notifier_unregister(struct scmi_device *sdev, 1530 1530 u8 proto_id, u8 evt_id,