Re: [PROBLEM linux-next] drivers/hwmon/aht10.c:224: warning: Function parameter or struct member 'data' not described in 'aht10_interval_write'

From: Guenter Roeck
Date: Thu Jul 11 2024 - 13:12:37 EST


On 7/11/24 09:57, Mirsad Todorovac wrote:
Hi all,

On the linux-next vanilla tree next-20240709, there is a lot of complaining about
code like these, which is not an error, but it seems like documentation lags behind
the [dynamic] source development.

If you are interested in reporting these to the respective maintainers and developers,
give me a ping.

drivers/hwmon/aht10.c:224: warning: Function parameter or struct member 'data' not described in 'aht10_interval_write'
drivers/hwmon/aht10.c:224: warning: Function parameter or struct member 'val' not described in 'aht10_interval_write'
drivers/hwmon/aht10.c:235: warning: Function parameter or struct member 'data' not described in 'aht10_interval_read'
drivers/hwmon/aht10.c:235: warning: Function parameter or struct member 'val' not described in 'aht10_interval_read'
drivers/hwmon/aht10.c:244: warning: Function parameter or struct member 'data' not described in 'aht10_temperature1_read'
drivers/hwmon/aht10.c:244: warning: Function parameter or struct member 'val' not described in 'aht10_temperature1_read'
drivers/hwmon/aht10.c:259: warning: Function parameter or struct member 'data' not described in 'aht10_humidity1_read'
drivers/hwmon/aht10.c:259: warning: Function parameter or struct member 'val' not described in 'aht10_humidity1_read'


I'll be happy to accept patches, but plain reports like this are just noise.

Guenter