[PATCH 14/18] docs: kdoc_re: handle strings and escape chars on NextMatch

Mauro Carvalho Chehab
2026-03-02T16:41:11Z

The logic inside NestedMatch currently doesn't consider that
function arguments may have chars and strings, which may
eventually contain delimiters.

Add logic to handle strings and escape characters on them.

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 | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)

diff --git a/tools/lib/python/kdoc/kdoc_re.py b/tools/lib/python/kdoc/kdoc_re.py
index 664c04c8cc9f..0a7f12616f9f 100644
--- a/tools/lib/python/kdoc/kdoc_re.py
+++ b/tools/lib/python/kdoc/kdoc_re.py
@@ -216,6 +216,8 @@ class NestedMatch:
for match_re in regex.finditer(line):
start = match_re.start()
offset = match_re.end()
+ string_char = None
+ escape = False

d = line[offset - 1]
if d not in self.DELIMITER_PAIRS:
@@ -229,6 +231,22 @@ class NestedMatch:

d = line[pos]

+ if escape:
+ escape = False
+ continue
+
+ if string_char:
+ if d == '\\':
+ escape = True
+ elif d == string_char:
+ string_char = None
+
+ continue
+
+ if d in ('"', "'"):
+ string_char = d
+ continue
+
if d in self.DELIMITER_PAIRS:
end = self.DELIMITER_PAIRS[d]

--
2.52.0