> -----Original Message-----
> From: Intel-wired-lan <intel-wired-lan-bounces@osuosl.org> On Behalf
> Of Mauro Carvalho Chehab
> Sent: Wednesday, January 28, 2026 5:50 PM
> To: Jonathan Corbet <corbet@lwn.net>; Linux Doc Mailing List <linux-
> doc@vger.kernel.org>
> Cc: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>;
> bpf@vger.kernel.org; intel-wired-lan@lists.osuosl.org; linux-
> kernel@vger.kernel.org; netdev@vger.kernel.org; Peter Zijlstra
> <peterz@infradead.org>; Randy Dunlap <rdunlap@infradead.org>; Stephen
> Rothwell <sfr@canb.auug.org.au>
> Subject: [Intel-wired-lan] [PATCH v2 18/25] docs: kdoc_re: Change
> NestedMath args replacement to \0
>
> Future patches will allow parsing each argument instead of the hole
> set. Prepare for it by changing the replace all args from
> \1 to \0.
>
> No functional changes.
>
> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
> ---
> tools/lib/python/kdoc/kdoc_parser.py | 2 +-
> tools/lib/python/kdoc/kdoc_re.py | 9 +++++----
> 2 files changed, 6 insertions(+), 5 deletions(-)
>
> diff --git a/tools/lib/python/kdoc/kdoc_parser.py
> b/tools/lib/python/kdoc/kdoc_parser.py
> index db140363104a..4d52a00acfad 100644
> --- a/tools/lib/python/kdoc/kdoc_parser.py
> +++ b/tools/lib/python/kdoc/kdoc_parser.py
> @@ -160,7 +160,7 @@ struct_xforms = [
> # is allowed.
> #
> struct_nested_prefixes = [
> - (re.compile(r'\bSTRUCT_GROUP\('), r'\1'),
> + (re.compile(r'\bSTRUCT_GROUP\('), r'\0'),
> ]
>
> #
> diff --git a/tools/lib/python/kdoc/kdoc_re.py
> b/tools/lib/python/kdoc/kdoc_re.py
> index b6e11ee0be21..28ca5032f40c 100644
> --- a/tools/lib/python/kdoc/kdoc_re.py
> +++ b/tools/lib/python/kdoc/kdoc_re.py
> @@ -271,8 +271,9 @@ class NestedMatch:
> It matches a regex that it is followed by a delimiter,
> replacing occurrences only if all delimiters are paired.
>
> - if r'\1' is used, it works just like re: it places there the
> - matched paired data with the delimiter stripped.
> + if r'\0' is used, it works on a similar way of using
> re.group(0):
> + it places the entire args of the matched paired data, with
> the
> + delimiter stripped.
>
> If count is different than zero, it will replace at most
> count
> items.
> @@ -288,9 +289,9 @@ class NestedMatch:
> # Value, ignoring start/end delimiters
> value = line[end:pos - 1]
>
> - # replaces \1 at the sub string, if \1 is used there
> + # replaces \0 at the sub string, if \0 is used there
> new_sub = sub
> - new_sub = new_sub.replace(r'\1', value)
> + new_sub = new_sub.replace(r'\0', value)
>
> out += new_sub
>
> --
> 2.52.0
Reviewed-by: Aleksandr Loktionov <aleksandr.loktionov@intel.com>