]> git.ipfire.org Git - thirdparty/linux.git/commitdiff
thermal: core: thermal_core.h: fix all kernel-doc warnings
authorRandy Dunlap <rdunlap@infradead.org>
Wed, 28 Jan 2026 06:24:46 +0000 (22:24 -0800)
committerRafael J. Wysocki <rafael.j.wysocki@intel.com>
Wed, 28 Jan 2026 21:07:27 +0000 (22:07 +0100)
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@infradead.org>
Reviewed-by: Lukasz Luba <lukasz.luba@arm.com>
Link: https://patch.msgid.link/20260128062446.402175-1-rdunlap@infradead.org
Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
drivers/thermal/thermal_core.h

index bdadd141aa24cf3c0afaf8d4c274e62bd796a4e9..d3acff602f9ce1703172540a906c59089c98505d 100644 (file)
@@ -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 {