[PATCH] thermal: db8500: remove kernel-doc notation from data

Randy Dunlap posted 1 patch 1 year, 11 months ago
drivers/thermal/db8500_thermal.c |    2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
[PATCH] thermal: db8500: remove kernel-doc notation from data
Posted by Randy Dunlap 1 year, 11 months ago
Don't mark data with a "/**" comment. kernel-doc does not support
documenting data definitions. This change prevents a kernel-doc
warning.

db8500_thermal.c:27: warning: cannot understand function prototype: 'const unsigned long db8500_thermal_points[] = '

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Hongbo Zhang <hongbo.zhang@stericsson.com>
Cc: Linus Walleij <linus.walleij@linaro.org>
Cc: Rafael J. Wysocki <rafael@kernel.org>
Cc: Daniel Lezcano <daniel.lezcano@linaro.org>
Cc: Zhang Rui <rui.zhang@intel.com>
Cc: Lukasz Luba <lukasz.luba@arm.com>
Cc: linux-pm@vger.kernel.org
---
 drivers/thermal/db8500_thermal.c |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff -- a/drivers/thermal/db8500_thermal.c b/drivers/thermal/db8500_thermal.c
--- a/drivers/thermal/db8500_thermal.c
+++ b/drivers/thermal/db8500_thermal.c
@@ -20,7 +20,7 @@
 #define PRCMU_DEFAULT_MEASURE_TIME	0xFFF
 #define PRCMU_DEFAULT_LOW_TEMP		0
 
-/**
+/*
  * db8500_thermal_points - the interpolation points that trigger
  * interrupts
  */
Re: [PATCH] thermal: db8500: remove kernel-doc notation from data
Posted by Linus Walleij 1 year, 11 months ago
On Mon, Jan 15, 2024 at 2:01 AM Randy Dunlap <rdunlap@infradead.org> wrote:

> Don't mark data with a "/**" comment. kernel-doc does not support
> documenting data definitions. This change prevents a kernel-doc
> warning.
>
> db8500_thermal.c:27: warning: cannot understand function prototype: 'const unsigned long db8500_thermal_points[] = '
>
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> Cc: Hongbo Zhang <hongbo.zhang@stericsson.com>
> Cc: Linus Walleij <linus.walleij@linaro.org>
> Cc: Rafael J. Wysocki <rafael@kernel.org>
> Cc: Daniel Lezcano <daniel.lezcano@linaro.org>
> Cc: Zhang Rui <rui.zhang@intel.com>
> Cc: Lukasz Luba <lukasz.luba@arm.com>
> Cc: linux-pm@vger.kernel.org

Fair enough,
Reviewed-by: Linus Walleij <linus.walleij@linaro.org>

Yours,
Linus Walleij