uio: fix some kernel-doc markups

The definitions for (devm_)uio_register_device should be
at the header file, as the macros are there. The ones
inside uio.c refer, instead, to __(devm_)uio_register_device.

Update them and add new kernel-doc markups for the macros.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/82ab7b68d271aeda7396e369ff8a629491b9d628.1603469755.git.mchehab+huawei@kernel.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
Mauro Carvalho Chehab 2020-10-23 18:33:17 +02:00 committed by Greg Kroah-Hartman
parent 7bbd2584ea
commit 9f38abefd3
2 changed files with 18 additions and 2 deletions

View File

@ -906,7 +906,7 @@ static void uio_device_release(struct device *dev)
}
/**
* uio_register_device - register a new userspace IO device
* __uio_register_device - register a new userspace IO device
* @owner: module that creates the new device
* @parent: parent device
* @info: UIO device capabilities
@ -1002,7 +1002,7 @@ static void devm_uio_unregister_device(struct device *dev, void *res)
}
/**
* devm_uio_register_device - Resource managed uio_register_device()
* __devm_uio_register_device - Resource managed uio_register_device()
* @owner: module that creates the new device
* @parent: parent device
* @info: UIO device capabilities

View File

@ -117,6 +117,14 @@ extern int __must_check
struct uio_info *info);
/* use a define to avoid include chaining to get THIS_MODULE */
/**
* uio_register_device - register a new userspace IO device
* @parent: parent device
* @info: UIO device capabilities
*
* returns zero on success or a negative error code.
*/
#define uio_register_device(parent, info) \
__uio_register_device(THIS_MODULE, parent, info)
@ -129,6 +137,14 @@ extern int __must_check
struct uio_info *info);
/* use a define to avoid include chaining to get THIS_MODULE */
/**
* devm_uio_register_device - Resource managed uio_register_device()
* @parent: parent device
* @info: UIO device capabilities
*
* returns zero on success or a negative error code.
*/
#define devm_uio_register_device(parent, info) \
__devm_uio_register_device(THIS_MODULE, parent, info)