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

scripts/kernel-doc.py: convert message output to an interactor

Browse Source 
Instead of directly printing output messages, change kdoc classes
to return an interactor with the output message, letting the
actual display to happen at the command-line command.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/557304c8458f1fb4aa2e833f4bdaff953094ddcb.1744106242.git.mchehab+huawei@kernel.org
This commit is contained in:
Mauro Carvalho Chehab
2025-04-08 18:09:14 +08:00
committed by Jonathan Corbet
parent 1d6fea640e
commit 4fa5e41137
3 changed files with 104 additions and 91 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
scripts/lib/kdoc/kdoc_files.py
View File

@@ -229,9 +229,10 @@ class KernelFiles():
def out_msg(self, fname, name, arg):
"""
Output messages from a file name using the output style filtering.
Return output messages from a file name using the output style
filtering.
If output type was not handled by the syler, return False.
If output type was not handled by the syler, return None.
"""
# NOTE: we can add rules here to filter out unwanted parts,
@@ -242,7 +243,8 @@ class KernelFiles():
def msg(self, enable_lineno=False, export=False, internal=False,
symbol=None, nosymbol=None):
"""
Interacts over the kernel-doc results and output messages.
Interacts over the kernel-doc results and output messages,
returning kernel-doc markups on each interaction
"""
function_table = self.config.function_table
@@ -261,10 +263,15 @@ class KernelFiles():
function_table, enable_lineno)
for fname, arg_tuple in self.results:
msg = ""
for name, arg in arg_tuple:
if self.out_msg(fname, name, arg):
msg += self.out_msg(fname, name, arg)
if msg is None:
ln = arg.get("ln", 0)
dtype = arg.get('type', "")
self.config.log.warning("%s:%d Can't handle %s",
fname, ln, dtype)
if msg:
yield fname, msg