From: Andrew Morton Might as well do it in kernel-doc form, yes? Cc: Rolf Eike Beer Signed-off-by: Andrew Morton --- fs/char_dev.c | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff -puN fs/char_dev.c~add-function-documentation-for-register_chrdev-fix fs/char_dev.c --- a/fs/char_dev.c~add-function-documentation-for-register_chrdev-fix +++ a/fs/char_dev.c @@ -182,17 +182,16 @@ int alloc_chrdev_region(dev_t *dev, unsi return 0; } -/* - * Register a major number for character devices. - * - * major: major device number or 0 for dynamic allocation - * name: name of this range of devices - * fops: file operations associated with this devices +/** + * register_chrdev() - Register a major number for character devices. + * @major: major device number or 0 for dynamic allocation + * @name: name of this range of devices + * @fops: file operations associated with this devices * - * If major == 0 this functions will dynamically allocate a major and return + * If @major == 0 this functions will dynamically allocate a major and return * its number. * - * If major > 0 this function will attempt to reserve a device with the given + * If @major > 0 this function will attempt to reserve a device with the given * major number and will return zero on success. * * Returns a -ve errno on failure. _