Changes in c_lex.py

2ca0b54dca438edb0f6b0eec7913d3cab60ddebf - docs: c_lex.py: store logger on its data

Mon, 23 Mar 2026 10:10:53 +0100

docs: c_lex.py: store logger on its dataBy having the logger stored there, any code using CTokenizer canlog messages there.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <467979dc18149e4b2a7113c178e0cb07919632f2.1774256269.git.mchehab+huawei@kernel.org> List of files: /linux/tools/lib/python/kdoc/c_lex.py

8c0b7c0d3c0e640b3ebb7f1f648ea322e56c227a - docs: kdoc: add c_lex to generated documentation

Wed, 18 Mar 2026 10:11:03 +0100

docs: kdoc: add c_lex to generated documentationDo some fixes at groups() description for it to be parsed bySphinx and add it to the documentation.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <799178cf30dd4022fdb1d029ba998a458e037b52.1773823995.git.mchehab+huawei@kernel.org> List of files: /linux/tools/lib/python/kdoc/c_lex.py

024e200e2a89d71dceff7d1bff8ae77b145726e0 - docs: c_lex: setup a logger to report tokenizer issues

Tue, 17 Mar 2026 19:09:38 +0100

docs: c_lex: setup a logger to report tokenizer issuesReport file that has issues detected via CMatch and CTokenizer.This is done by setting up a logger that will be overriden bykdoc_parser, when used on it.Signed-off-by: Mauro Carvalho Chehab Reviewed-by: Aleksandr Loktionov Signed-off-by: Jonathan Corbet Message-ID: <903ad83ae176196a50444e66177a4f5bcdef5199.1773770483.git.mchehab+huawei@kernel.org> List of files: /linux/tools/lib/python/kdoc/c_lex.py

9aaeb817ef4f794d1dbb8736332a64b5dae9521c - docs: c_lex: properly implement a sub() method for CMatch

Tue, 17 Mar 2026 19:09:32 +0100

docs: c_lex: properly implement a sub() method for CMatchImplement a sub() method to do what it is expected, parsingbackref arguments like \0, \1, \2, ...Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: List of files: /linux/tools/lib/python/kdoc/c_lex.py

f1cf9f7cd66f1f90c4c3beb0885b6f7771e1b419 - docs: kdoc: create a CMatch to match nested C blocks

Tue, 17 Mar 2026 19:09:30 +0100

docs: kdoc: create a CMatch to match nested C blocksThe NextMatch code is complex, and will become even more complexif we add there support for arguments.Now that we have a tokenizer, we can use a better solution,easier to be understood.Yet, to improve performance, it is better to make it use apreviously tokenized code, changing its ABI.So, reimplement NextMatch using the CTokener class. Once itis done, we can drop NestedMatch.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: List of files: /linux/tools/lib/python/kdoc/c_lex.py

df50e848f67523195ee0b4c6d2c01823e36a15e7 - docs: add a C tokenizer to be used by kernel-doc

Tue, 17 Mar 2026 19:09:25 +0100

docs: add a C tokenizer to be used by kernel-docHandling C code purely using regular expressions doesn't work well.Add a C tokenizer to help doing it the right way.The tokenizer was written using as basis the Python re documentationtokenizer example from: https://docs.python.org/3/library/re.html#writing-a-tokenizerSigned-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <39787bb8022e10c65df40c746077f7f66d07ffed.1773770483.git.mchehab+huawei@kernel.org> List of files: /linux/tools/lib/python/kdoc/c_lex.py