drivers/hwmon/yogafan.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
The file description comment starts with "/**", which is reserved for
kernel-doc comments. scripts/kernel-doc then warns when building the
documentation:
Warning: drivers/hwmon/yogafan.c:2 This comment starts with '/**',
but isn't a kernel-doc comment. Refer to
Documentation/doc-guide/kernel-doc.rst
Change it to a plain "/*" comment since it does not document any
function or struct.
Signed-off-by: hanzhijian <hanzhijian1991@gmail.com>
---
drivers/hwmon/yogafan.c | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/drivers/hwmon/yogafan.c b/drivers/hwmon/yogafan.c
index 48fa5148d..278cb089b 100644
--- a/drivers/hwmon/yogafan.c
+++ b/drivers/hwmon/yogafan.c
@@ -1,5 +1,5 @@
// SPDX-License-Identifier: GPL-2.0-only
-/**
+/*
* yoga_fan.c - Lenovo Yoga/Legion Fan Hardware Monitoring Driver
*
* Provides fan speed monitoring for Lenovo Yoga, Legion, and IdeaPad
--
2.43.0
On 8/22/26 18:38, hanzhijian wrote: > The file description comment starts with "/**", which is reserved for > kernel-doc comments. scripts/kernel-doc then warns when building the > documentation: > > Warning: drivers/hwmon/yogafan.c:2 This comment starts with '/**', > but isn't a kernel-doc comment. Refer to > Documentation/doc-guide/kernel-doc.rst > > Change it to a plain "/*" comment since it does not document any > function or struct. > > Signed-off-by: hanzhijian <hanzhijian1991@gmail.com> No change log, no change other than the commit message, that change does not add any value, and I already applied this patch and sent out a note that I did. Are you playing with me ? I am inclined to drop this patch. Guenter > --- > drivers/hwmon/yogafan.c | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/drivers/hwmon/yogafan.c b/drivers/hwmon/yogafan.c > index 48fa5148d..278cb089b 100644 > --- a/drivers/hwmon/yogafan.c > +++ b/drivers/hwmon/yogafan.c > @@ -1,5 +1,5 @@ > // SPDX-License-Identifier: GPL-2.0-only > -/** > +/* > * yoga_fan.c - Lenovo Yoga/Legion Fan Hardware Monitoring Driver > * > * Provides fan speed monitoring for Lenovo Yoga, Legion, and IdeaPad
My apologies, Guenter. You are right, and I'm sorry for the noise. I sent the "please drop" note by mistake, then over-corrected by resending it as v2 with no code change. That was the wrong way to handle it. Please drop the patch entirely. Sorry for wasting your time. hanzhijian
© 2016 - 2026 Red Hat, Inc.