> -----Original Message----- > From: Intel-wired-lan <[email protected]> On Behalf > Of Mauro Carvalho Chehab > Sent: Thursday, January 29, 2026 9:08 AM > To: Jonathan Corbet <[email protected]>; Linux Doc Mailing List <linux- > [email protected]> > Cc: Mauro Carvalho Chehab <[email protected]>; > [email protected]; [email protected]; linux- > [email protected]; [email protected]; > [email protected]; Mauro Carvalho Chehab <[email protected]>; > Randy Dunlap <[email protected]> > Subject: [Intel-wired-lan] [PATCH v3 18/30] 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 <[email protected]> > --- > 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 7b7ddc50ac36..8933e1a62776 100644 > --- a/tools/lib/python/kdoc/kdoc_re.py > +++ b/tools/lib/python/kdoc/kdoc_re.py > @@ -289,8 +289,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. > @@ -306,9 +307,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 <[email protected]>
