Gh0st
/
linux
mirror of https://github.com/torvalds/linux.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: kdoc_parser: use '@' for Excess enum value 

kdoc is looking for "@value" here, so use that kind of string in the
warning message. The "%value" can be confusing.

This changes:
Warning: drivers/net/wireless/mediatek/mt76/testmode.h:92 Excess enum value '%MT76_TM_ATTR_TX_PENDING' description in 'mt76_testmode_attr'

to this:
Warning: drivers/net/wireless/mediatek/mt76/testmode.h:92 Excess enum value '@MT76_TM_ATTR_TX_PENDING' description in 'mt76_testmode_attr'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <20251126061752.3497106-1-rdunlap@infradead.org>
This commit is contained in:
Randy Dunlap 2025-11-25 22:17:52 -08:00 committed by Jonathan Corbet
parent e36a7b1e17
commit 18182f9758
1 changed files with 1 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
tools/lib/python/kdoc/kdoc_parser.py
View File

@ -922,7 +922,7 @@ class KernelDoc:
for k in self.entry.parameterdescs: for k in self.entry.parameterdescs:
if k not in member_set: if k not in member_set:
self.emit_msg(ln, self.emit_msg(ln,
f"Excess enum value '%{k}' description in '{declaration_name}'") f"Excess enum value '@{k}' description in '{declaration_name}'")
self.output_declaration('enum', declaration_name, self.output_declaration('enum', declaration_name,
purpose=self.entry.declaration_purpose) purpose=self.entry.declaration_purpose)