History

atm: atmdev: add function parameter names and description

kernel-doc reports function parameters not described for parameters that are not named. Add parameter names for these functions and then describe the function parameters in kernel-doc format. Fixes these warnings: Warning: include/linux/atmdev.h:316 function parameter '' not described in 'register_atm_ioctl' Warning: include/linux/atmdev.h:321 function parameter '' not described in 'deregister_atm_ioctl'

Randy Dunlap committed 8 months ago

Commit c69855a1 parent 425e0801 file · +4 −2Browse files

Showing the changes to include/linux/atmdev.h (1 of 1 file). Show all

Unified · Split

include/linux/atmdev.h+4−2
@@ -309,17 +309,19 @@ struct atm_ioctl { · 308 unmodified lines
309309
310310 /**
311311 * register_atm_ioctl - register handler for ioctl operations
312+ * @ioctl: ioctl handler to register
312313 *
313314 * Special (non-device) handlers of ioctl's should
314315 * register here. If you're a normal device, you should
315316 * set .ioctl in your atmdev_ops instead.
316317 */
317−void register_atm_ioctl(struct atm_ioctl *);
318+void register_atm_ioctl(struct atm_ioctl *ioctl);
318319
319320 /**
320321 * deregister_atm_ioctl - remove the ioctl handler
322+ * @ioctl: ioctl handler to deregister
321323 */
322−void deregister_atm_ioctl(struct atm_ioctl *);
324+void deregister_atm_ioctl(struct atm_ioctl *ioctl);
323325
324326
325327 /* register_atmdevice_notifier - register atm_dev notify events