raspi/linux
1
0
Fork 1
mirror of https://github.com/raspberrypi/linux.git synced 2025-12-07 18:40:10 +00:00
Code Issues Projects Releases Wiki Activity

docs: kdoc: some tweaks to process_proto_function()

Browse Source 
Add a set of comments to process_proto_function and reorganize the logic
slightly; no functional change.

Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
Jonathan Corbet
2025-06-30 11:38:42 -06:00
parent 1aeb8099d0
commit 901f506945
1 changed files with 24 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
scripts/lib/kdoc/kdoc_parser.py
View File

@@ -1553,39 +1553,44 @@ class KernelDoc:
"""Ancillary routine to process a function prototype"""
# strip C99-style comments to end of line
r = KernRe(r"\/\/.*$", re.S)
line = r.sub('', line)
line = KernRe(r"\/\/.*$", re.S).sub('', line)
#
# Soak up the line's worth of prototype text, stopping at { or ; if present.
#
if KernRe(r'\s*#\s*define').match(line):
self.entry.prototype = line
elif line.startswith('#'):
# Strip other macros like #ifdef/#ifndef/#endif/...
pass
else:
elif not line.startswith('#'): # skip other preprocessor stuff
r = KernRe(r'([^\{]*)')
if r.match(line):
self.entry.prototype += r.group(1) + " "
#
# If we now have the whole prototype, clean it up and declare victory.
#
if '{' in line or ';' in line or KernRe(r'\s*#\s*define').match(line):
# strip comments and surrounding spaces
r = KernRe(r'/\*.*\*/')
self.entry.prototype = r.sub('', self.entry.prototype).strip()
self.entry.prototype = KernRe(r'/\*.*\*/').sub('', self.entry.prototype).strip()
#
# Handle self.entry.prototypes for function pointers like:
# int (*pcs_config)(struct foo)
# by turning it into
# int pcs_config(struct foo)
#
r = KernRe(r'^(\S+\s+)\(\s*\*(\S+)\)')
self.entry.prototype = r.sub(r'\1\2', self.entry.prototype)
#
# Handle special declaration syntaxes
#
if 'SYSCALL_DEFINE' in self.entry.prototype:
self.entry.prototype = self.syscall_munge(ln,
self.entry.prototype)
r = KernRe(r'TRACE_EVENT|DEFINE_EVENT|DEFINE_SINGLE_EVENT')
if r.search(self.entry.prototype):
self.entry.prototype = self.tracepoint_munge(ln,
self.entry.prototype)
else:
r = KernRe(r'TRACE_EVENT|DEFINE_EVENT|DEFINE_SINGLE_EVENT')
if r.search(self.entry.prototype):
self.entry.prototype = self.tracepoint_munge(ln,
self.entry.prototype)
#
# ... and we're done
#
self.dump_function(ln, self.entry.prototype)
self.reset_state(ln)