[PATCH 23/38] docs: kdoc_re: add a helper class to declare C function matches

Mauro Carvalho Chehab
2026-02-18T10:13:26Z

Add a more convenient class to match C functions and avoiding
issues at the beginning and ending of NestedMatch inits.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Reviewed-by: Aleksandr Loktionov <aleksandr.loktionov@intel.com>
---
tools/lib/python/kdoc/kdoc_re.py | 11 +++++++++++
1 file changed, 11 insertions(+)

diff --git a/tools/lib/python/kdoc/kdoc_re.py b/tools/lib/python/kdoc/kdoc_re.py
index cdc842f5fc8f..f72b80ea4f1b 100644
--- a/tools/lib/python/kdoc/kdoc_re.py
+++ b/tools/lib/python/kdoc/kdoc_re.py
@@ -383,3 +383,14 @@ class NestedMatch:
"""

return f'NestedMatch("{self.regex.regex.pattern}")'
+
+
+class CFunction(NestedMatch):
+ r"""
+ Variant of NestedMatch.
+
+ It overrides the init method to ensure that the regular expression will
+ start with a ``\b`` and end with a C function delimiter (open parenthesis).
+ """
+ def __init__(self, regex):
+ self.regex = KernRe(r"\b" + regex + r"\s*\(")
--
2.52.0