[PATCH net-next] ath5k: debug.h: fix enum ath5k_debug_level kernel-doc

[PATCH net-next] ath5k: debug.h: fix enum ath5k_debug_level kernel-doc

[Randy Dunlap]

Add a description for ATH5K_DEBUG_ANI and delete the descriptions for
3 undefined enum descriptions to prevent these warnings:

Warning: drivers/net/wireless/ath/ath5k/debug.h:111 Enum value
 'ATH5K_DEBUG_ANI' not described in enum 'ath5k_debug_level'
Warning: drivers/net/wireless/ath/ath5k/debug.h:111 Excess enum value
 '%ATH5K_DEBUG_DUMP_RX' description in 'ath5k_debug_level'
Warning: drivers/net/wireless/ath/ath5k/debug.h:111 Excess enum value
 '%ATH5K_DEBUG_DUMP_TX' description in 'ath5k_debug_level'
Warning: drivers/net/wireless/ath/ath5k/debug.h:111 Excess enum value
 '%ATH5K_DEBUG_TRACE' description in 'ath5k_debug_level'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
Cc: Jiri Slaby <jirislaby@kernel.org>
Cc: Nick Kossifidis <mickflemm@gmail.com>
Cc: Luis Chamberlain <mcgrof@kernel.org>
Cc: Johannes Berg <johannes@sipsolutions.net>
Cc: Andrew Lunn <andrew+netdev@lunn.ch>
Cc: "David S. Miller" <davem@davemloft.net>
Cc: Eric Dumazet <edumazet@google.com>
Cc: Jakub Kicinski <kuba@kernel.org>
Cc: Paolo Abeni <pabeni@redhat.com>
Cc: linux-wireless@vger.kernel.org
---
 drivers/net/wireless/ath/ath5k/debug.h |    4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

--- linux-next-20251127.orig/drivers/net/wireless/ath/ath5k/debug.h
+++ linux-next-20251127/drivers/net/wireless/ath/ath5k/debug.h
@@ -80,11 +80,9 @@ struct ath5k_dbg_info {
  * @ATH5K_DEBUG_CALIBRATE: periodic calibration
  * @ATH5K_DEBUG_TXPOWER: transmit power setting
  * @ATH5K_DEBUG_LED: led management
- * @ATH5K_DEBUG_DUMP_RX: print received skb content
- * @ATH5K_DEBUG_DUMP_TX: print transmit skb content
  * @ATH5K_DEBUG_DUMPBANDS: dump bands
  * @ATH5K_DEBUG_DMA: debug dma start/stop
- * @ATH5K_DEBUG_TRACE: trace function calls
+ * @ATH5K_DEBUG_ANI: debug Adaptive Noise Immunity
  * @ATH5K_DEBUG_DESC: descriptor setup
  * @ATH5K_DEBUG_ANY: show at any debug level
  *

Re: [PATCH net-next] ath5k: debug.h: fix enum ath5k_debug_level kernel-doc

[Simon Horman]

On Thu, Nov 27, 2025 at 05:04:01PM -0800, Randy Dunlap wrote:
> Add a description for ATH5K_DEBUG_ANI and delete the descriptions for
> 3 undefined enum descriptions to prevent these warnings:
> 
> Warning: drivers/net/wireless/ath/ath5k/debug.h:111 Enum value
>  'ATH5K_DEBUG_ANI' not described in enum 'ath5k_debug_level'
> Warning: drivers/net/wireless/ath/ath5k/debug.h:111 Excess enum value
>  '%ATH5K_DEBUG_DUMP_RX' description in 'ath5k_debug_level'
> Warning: drivers/net/wireless/ath/ath5k/debug.h:111 Excess enum value
>  '%ATH5K_DEBUG_DUMP_TX' description in 'ath5k_debug_level'
> Warning: drivers/net/wireless/ath/ath5k/debug.h:111 Excess enum value
>  '%ATH5K_DEBUG_TRACE' description in 'ath5k_debug_level'
> 
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>

Reviewed-by: Simon Horman <horms@kernel.org>