提交 24389b61 编写于 作者: S Sergey Shtylyov 提交者: Jessica Yu

module: fix up 'kernel-doc' comments

Some 'kernel-doc' function comments do not fully comply with the specified
format due to:

- missing () after the function name;

- "RETURNS:"/"Returns:" instead of "Return:" when documenting the function's
  result.

- empty line before describing the function's arguments.
Signed-off-by: NSergey Shtylyov <s.shtylyov@omprussia.ru>
Signed-off-by: NJessica Yu <jeyu@kernel.org>
上级 076aa52e
...@@ -727,13 +727,12 @@ bool __is_module_percpu_address(unsigned long addr, unsigned long *can_addr) ...@@ -727,13 +727,12 @@ bool __is_module_percpu_address(unsigned long addr, unsigned long *can_addr)
} }
/** /**
* is_module_percpu_address - test whether address is from module static percpu * is_module_percpu_address() - test whether address is from module static percpu
* @addr: address to test * @addr: address to test
* *
* Test whether @addr belongs to module static percpu area. * Test whether @addr belongs to module static percpu area.
* *
* RETURNS: * Return: %true if @addr is from module static percpu area
* %true if @addr is from module static percpu area
*/ */
bool is_module_percpu_address(unsigned long addr) bool is_module_percpu_address(unsigned long addr)
{ {
...@@ -957,11 +956,10 @@ static int try_stop_module(struct module *mod, int flags, int *forced) ...@@ -957,11 +956,10 @@ static int try_stop_module(struct module *mod, int flags, int *forced)
} }
/** /**
* module_refcount - return the refcount or -1 if unloading * module_refcount() - return the refcount or -1 if unloading
*
* @mod: the module we're checking * @mod: the module we're checking
* *
* Returns: * Return:
* -1 if the module is in the process of unloading * -1 if the module is in the process of unloading
* otherwise the number of references in the kernel to the module * otherwise the number of references in the kernel to the module
*/ */
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册