LKML Archive on lore.kernel.org
help / color / mirror / Atom feed
* [PATCH] kernel/power: unmark 'state' functions as kernel-doc
@ 2021-08-10  1:44 Randy Dunlap
  2021-08-16 16:50 ` Rafael J. Wysocki
  0 siblings, 1 reply; 2+ messages in thread
From: Randy Dunlap @ 2021-08-10  1:44 UTC (permalink / raw)
  To: linux-kernel
  Cc: Randy Dunlap, Rafael J. Wysocki, Pavel Machek, Len Brown, linux-pm

Fix kernel-doc warnings in kernel/power/main.c by unmarking the
comment block as kernel-doc notation. This eliminates the following
kernel-doc warnings:

kernel/power/main.c:593: warning: expecting prototype for state(). Prototype was for state_show() instead
kernel/power/main.c:593: warning: Function parameter or member 'kobj' not described in 'state_show'
kernel/power/main.c:593: warning: Function parameter or member 'attr' not described in 'state_show'
kernel/power/main.c:593: warning: Function parameter or member 'buf' not described in 'state_show'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: "Rafael J. Wysocki" <rjw@rjwysocki.net>
Cc: Pavel Machek <pavel@ucw.cz>
Cc: Len Brown <len.brown@intel.com>
Cc: linux-pm@vger.kernel.org
---
 kernel/power/main.c |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

--- linux-next-20210809.orig/kernel/power/main.c
+++ linux-next-20210809/kernel/power/main.c
@@ -577,7 +577,7 @@ static inline void pm_print_times_init(v
 
 struct kobject *power_kobj;
 
-/**
+/*
  * state - control system sleep states.
  *
  * show() returns available sleep state labels, which may be "mem", "standby",

^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: [PATCH] kernel/power: unmark 'state' functions as kernel-doc
  2021-08-10  1:44 [PATCH] kernel/power: unmark 'state' functions as kernel-doc Randy Dunlap
@ 2021-08-16 16:50 ` Rafael J. Wysocki
  0 siblings, 0 replies; 2+ messages in thread
From: Rafael J. Wysocki @ 2021-08-16 16:50 UTC (permalink / raw)
  To: Randy Dunlap
  Cc: Linux Kernel Mailing List, Rafael J. Wysocki, Pavel Machek,
	Len Brown, Linux PM

On Tue, Aug 10, 2021 at 3:44 AM Randy Dunlap <rdunlap@infradead.org> wrote:
>
> Fix kernel-doc warnings in kernel/power/main.c by unmarking the
> comment block as kernel-doc notation. This eliminates the following
> kernel-doc warnings:
>
> kernel/power/main.c:593: warning: expecting prototype for state(). Prototype was for state_show() instead
> kernel/power/main.c:593: warning: Function parameter or member 'kobj' not described in 'state_show'
> kernel/power/main.c:593: warning: Function parameter or member 'attr' not described in 'state_show'
> kernel/power/main.c:593: warning: Function parameter or member 'buf' not described in 'state_show'
>
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> Cc: "Rafael J. Wysocki" <rjw@rjwysocki.net>
> Cc: Pavel Machek <pavel@ucw.cz>
> Cc: Len Brown <len.brown@intel.com>
> Cc: linux-pm@vger.kernel.org
> ---
>  kernel/power/main.c |    2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> --- linux-next-20210809.orig/kernel/power/main.c
> +++ linux-next-20210809/kernel/power/main.c
> @@ -577,7 +577,7 @@ static inline void pm_print_times_init(v
>
>  struct kobject *power_kobj;
>
> -/**
> +/*
>   * state - control system sleep states.
>   *
>   * show() returns available sleep state labels, which may be "mem", "standby",

Applied as 5.15 material, thanks!

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2021-08-16 16:51 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-08-10  1:44 [PATCH] kernel/power: unmark 'state' functions as kernel-doc Randy Dunlap
2021-08-16 16:50 ` Rafael J. Wysocki

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).