linux-kernel - Re: [PATCH] thermal: core: thermal_core.h: fix all kernel-doc warnings

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <CAJZ5v0hNByYiRzsVo1tVPW_Fha_PVbW-4aYVvHrPrQ0fz64e=w@mail.gmail.com>
Date: Wed, 28 Jan 2026 22:08:38 +0100
From: "Rafael J. Wysocki" <rafael@...nel.org>
To: Lukasz Luba <lukasz.luba@....com>, Randy Dunlap <rdunlap@...radead.org>, 
	Daniel Lezcano <daniel.lezcano@...aro.org>
Cc: linux-kernel@...r.kernel.org, Zhang Rui <rui.zhang@...el.com>, 
	linux-pm@...r.kernel.org
Subject: Re: [PATCH] thermal: core: thermal_core.h: fix all kernel-doc warnings

On Wed, Jan 28, 2026 at 11:09 AM Lukasz Luba <lukasz.luba@....com> wrote:
>
>
>
> On 1/28/26 06:24, Randy Dunlap wrote:
> > Resolve all kernel-doc warnings in thermal_core.h:
> >
> > Warning: drivers/thermal/thermal_core.h:99 bad line: trip point.
> > Warning: drivers/thermal/thermal_core.h:101 bad line: passive trip point.
> > Warning: drivers/thermal/thermal_core.h:152 struct member 'trips_attribute_group' not described in 'thermal_zone_device'
> > Warning: drivers/thermal/thermal_core.h:152 struct member 'debugfs' not described in 'thermal_zone_device'
> > Warning: drivers/thermal/thermal_core.h:152 struct member 'user_thresholds' not described in 'thermal_zone_device'
> >
> > Signed-off-by: Randy Dunlap <rdunlap@...radead.org>
> > ---
> > Cc: Rafael J. Wysocki <rafael@...nel.org>
> > Cc: Daniel Lezcano <daniel.lezcano@...aro.org>
> > Cc: Zhang Rui <rui.zhang@...el.com>
> > Cc: Lukasz Luba <lukasz.luba@....com>
> > Cc: linux-pm@...r.kernel.org
> >
> >   drivers/thermal/thermal_core.h |    7 +++++--
> >   1 file changed, 5 insertions(+), 2 deletions(-)
> >
> > --- linux-next-20260126.orig/drivers/thermal/thermal_core.h
> > +++ linux-next-20260126/drivers/thermal/thermal_core.h
> > @@ -77,6 +77,7 @@ struct thermal_governor {
> >    * @device: &struct device for this thermal zone
> >    * @removal:        removal completion
> >    * @resume: resume completion
> > + * @trips_attribute_group: trip point sysfs attributes
> >    * @trips_high:     trips above the current zone temperature
> >    * @trips_reached:  trips below or at the current zone temperature
> >    * @trips_invalid:  trips with invalid temperature
> > @@ -97,9 +98,9 @@ struct thermal_governor {
> >    * @emul_temperature:       emulated temperature when using CONFIG_THERMAL_EMULATION
> >    * @passive:                1 if you've crossed a passive trip point, 0 otherwise.
> >    * @prev_low_trip:  the low current temperature if you've crossed a passive
> > -                     trip point.
> > + *                   trip point.
> >    * @prev_high_trip: the above current temperature if you've crossed a
> > -                     passive trip point.
> > + *                   passive trip point.
> >    * @ops:    operations this &thermal_zone_device supports
> >    * @tzp:    thermal zone parameters
> >    * @governor:       pointer to the governor for this thermal zone
> > @@ -111,6 +112,8 @@ struct thermal_governor {
> >    * @poll_queue:     delayed work for polling
> >    * @notify_event: Last notification event
> >    * @state:  current state of the thermal zone
> > + * @debugfs: this thermal zone device's thermal zone debug info
> > + * @user_thresholds: list of userspace thresholds for temp. limit notifications
> >    * @trips:  array of struct thermal_trip objects
> >    */
> >   struct thermal_zone_device {
>
>
> Reviewed-by: Lukasz Luba <lukasz.luba@....com>

Applied as 6.20 material, thanks!