2023-11-07 00:54:19

by Randy Dunlap

[permalink] [raw]
Subject: [PATCH v2] PM: domains: fix inappropriate use of kernel-doc

There is no mechanism for using kernel-doc notation on a data item
(only struct/union/enum definitions, functions, and function-like
macros). Since the comment does not add any useful information,
just drop it completely to avoid a kernel-doc warning:

drivers/base/power/domain_governor.c:412: warning: cannot understand function prototype: 'struct dev_power_governor pm_domain_always_on_gov = '

Signed-off-by: Randy Dunlap <[email protected]>
Cc: "Rafael J. Wysocki" <[email protected]>
Cc: Kevin Hilman <[email protected]>
Cc: Ulf Hansson <[email protected]>
Cc: [email protected]
---
v2: drop the comment completely (Ulf)

drivers/base/power/domain_governor.c | 3 ---
1 file changed, 3 deletions(-)

diff -- a/drivers/base/power/domain_governor.c b/drivers/base/power/domain_governor.c
--- a/drivers/base/power/domain_governor.c
+++ b/drivers/base/power/domain_governor.c
@@ -406,9 +406,6 @@ struct dev_power_governor simple_qos_gov
.power_down_ok = default_power_down_ok,
};

-/**
- * pm_genpd_gov_always_on - A governor implementing an always-on policy
- */
struct dev_power_governor pm_domain_always_on_gov = {
.suspend_ok = default_suspend_ok,
};