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

Unified · Split

include/linux/atmdev.h+4−2
@@ -309,17 +309,19 @@ struct atm_ioctl { · 308 unmodified lines
309 309
310/**310/**
311 * register_atm_ioctl - register handler for ioctl operations311 * register_atm_ioctl - register handler for ioctl operations
312 * @ioctl: ioctl handler to register
312 *313 *
313 * Special (non-device) handlers of ioctl's should314 * Special (non-device) handlers of ioctl's should
314 * register here. If you're a normal device, you should315 * register here. If you're a normal device, you should
315 * set .ioctl in your atmdev_ops instead.316 * set .ioctl in your atmdev_ops instead.
316 */317 */
317void register_atm_ioctl(struct atm_ioctl *);318void register_atm_ioctl(struct atm_ioctl *ioctl);
318 319
319/**320/**
320 * deregister_atm_ioctl - remove the ioctl handler321 * deregister_atm_ioctl - remove the ioctl handler
322 * @ioctl: ioctl handler to deregister
321 */323 */
322void deregister_atm_ioctl(struct atm_ioctl *);324void deregister_atm_ioctl(struct atm_ioctl *ioctl);
323 325
324 326
325/* register_atmdevice_notifier - register atm_dev notify events327/* register_atmdevice_notifier - register atm_dev notify events