qiurui
/
linux-kernelorg-stable
mirror of https://kernel.googlesource.com/pub/scm/linux/kernel/git/stable/linux.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: kdoc: directly access the always-there KdocItem fields 

They are part of the interface, so use them directly.  This allows the
removal of the transitional __dict__ hack in KdocItem.

Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
Jonathan Corbet 2025-07-02 13:55:56 -06:00
parent 08b8dc43d1
commit bd5628bf60
2 changed files with 8 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
scripts/lib/kdoc/kdoc_item.py
View File

@ -23,10 +23,7 @@ class KdocItem:
self.other_stuff = other_stuff
def get(self, key, default = None):
ret = self.other_stuff.get(key, default)
if ret == default:
return self.__dict__.get(key, default)
return ret
return self.other_stuff.get(key, default)
def __getitem__(self, key):
return self.get(key)

16
scripts/lib/kdoc/kdoc_output.py
View File

@ -124,9 +124,7 @@ class OutputFormat:
Output warnings for identifiers that will be displayed.
"""
warnings = args.get('warnings', [])
for log_msg in warnings:
for log_msg in args.warnings:
self.config.warning(log_msg)
def check_doc(self, name, args):
@ -184,7 +182,7 @@ class OutputFormat:
self.data = ""
dtype = args.get('type', "")
dtype = args.type
if dtype == "doc":
self.out_doc(fname, name, args)
@ -373,7 +371,7 @@ class RestFormat(OutputFormat):
signature = args['functiontype'] + " "
signature += name + " ("
ln = args.get('declaration_start_line', 0)
ln = args.declaration_start_line
count = 0
for parameter in args.parameterlist:
if count != 0:
@ -445,7 +443,7 @@ class RestFormat(OutputFormat):
def out_enum(self, fname, name, args):
oldprefix = self.lineprefix
ln = args.get('declaration_start_line', 0)
ln = args.declaration_start_line
self.data += f"\n\n.. c:enum:: {name}\n\n"
@ -474,7 +472,7 @@ class RestFormat(OutputFormat):
def out_typedef(self, fname, name, args):
oldprefix = self.lineprefix
ln = args.get('declaration_start_line', 0)
ln = args.declaration_start_line
self.data += f"\n\n.. c:type:: {name}\n\n"
@ -492,8 +490,8 @@ class RestFormat(OutputFormat):
purpose = args.get('purpose', "")
declaration = args.get('definition', "")
dtype = args.get('type', "struct")
ln = args.get('declaration_start_line', 0)
dtype = args.type
ln = args.declaration_start_line
self.data += f"\n\n.. c:{dtype}:: {name}\n\n"