[<prev] [next>] [<thread-prev] [day] [month] [year] [list]
Message-ID: <20231221172319.GD1056991@kernel.org>
Date: Thu, 21 Dec 2023 18:23:19 +0100
From: Simon Horman <horms@...nel.org>
To: Jonathan Corbet <corbet@....net>
Cc: Johannes Berg <johannes@...solutions.net>,
"David S. Miller" <davem@...emloft.net>,
Eric Dumazet <edumazet@...gle.com>,
Jakub Kicinski <kuba@...nel.org>, Paolo Abeni <pabeni@...hat.com>,
linux-wireless@...r.kernel.org, netdev@...r.kernel.org
Subject: Re: [PATCH net] wifi: mac80211: address some kerneldoc warnings
On Wed, Dec 20, 2023 at 03:57:55PM -0700, Jonathan Corbet wrote:
> include/net/mac80111.h contains a number of either excess or incorrect
> kerneldoc entries for structure members, leading to these warnings:
>
> ./include/net/mac80211.h:491: warning: Excess struct member 'rssi' description in 'ieee80211_event'
> ./include/net/mac80211.h:491: warning: Excess struct member 'mlme' description in 'ieee80211_event'
> ./include/net/mac80211.h:491: warning: Excess struct member 'ba' description in 'ieee80211_event'
> ./include/net/mac80211.h:777: warning: Excess struct member 'ack_enabled' description in 'ieee80211_bss_conf'
> ./include/net/mac80211.h:1222: warning: Excess struct member 'ampdu_ack_len' description in 'ieee80211_tx_info'
> ./include/net/mac80211.h:1222: warning: Excess struct member 'ampdu_len' description in 'ieee80211_tx_info'
> ./include/net/mac80211.h:1222: warning: Excess struct member 'ack_signal' description in 'ieee80211_tx_info'
> ./include/net/mac80211.h:2920: warning: Excess struct member 'radiotap_he' description in 'ieee80211_hw'
>
> Fix or remove the entries as needed. This change removes 208 warnings from
> a "make htmldocs" build.
>
> Signed-off-by: Jonathan Corbet <corbet@....net>
Thanks Jonathan,
I verified that the above mentioned warnings are present in
next-20231221 without this patch, but not with this patch.
Reviewed-by: Simon Horman <horms@...nel.org>
Powered by blists - more mailing lists