From: Omokefe Emmanuel Onanaroghene <emmaonana18@gmail.com>
To: mchehab+huawei@kernel.org
Cc: corbet@lwn.net, linux-doc@vger.kernel.org,
linux-kernel@vger.kernel.org, skhan@linuxfoundation.org,
rdunlap@infradead.org, mchehab@kernel.org, paulmck@kernel.org,
linusw@kernel.org, Julia.Lawall@inria.fr, gary@garyguo.net,
rmk+kernel@armlinux.org.uk, hemanth.selam@gmail.com,
Omokefe Emmanuel Onanaroghene <emmaonana18@gmail.com>
Subject: [PATCH v2 0/2] docs: kdoc: convert tracepoint parsing to CMatch
Date: Fri, 23 Oct 2026 14:04:13 +0100 [thread overview]
Message-ID: <20261023130444.26270-1-emmaonana18@gmail.com> (raw)
In-Reply-To: <20261016231148.7b5a88ef@foz.lan>
Mauro suggested handling tracepoint and syscall declarations with pure
CMatch transformations, and keeping any nested-comma tokenizer correction
in a separate patch. This series follows that split.
Patch 1 fixes CMatch argument grouping so delimiters inside nested
expressions do not split the outer macro arguments. Patch 2 replaces the
procedural syscall and tracepoint munging with CMatch transformations,
including support for the TRACE_EVENT_FN() family, and adds parser tests.
Omokefe Emmanuel Onanaroghene (2):
docs: kdoc: handle nested commas in CMatch arguments
docs: kdoc: handle TRACE_EVENT_FN() with CMatch
tools/lib/python/kdoc/c_lex.py | 22 ++++++-
tools/lib/python/kdoc/kdoc_parser.py | 94 ++-------------------------
tools/lib/python/kdoc/xforms_lists.py | 39 +++++++++++
tools/unittests/test_cmatch.py | 7 ++
tools/unittests/test_kdoc_parser.py | 56 ++++++++++++++++
5 files changed, 129 insertions(+), 89 deletions(-)
base-commit: 90d9f76ccb72ec024ef476b4229f3dd1957d7b26
--
2.43.0
next prev parent reply other threads:[~2026-10-23 13:05 UTC|newest]
Thread overview: 15+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-10-02 4:15 [PATCH] docs: kdoc: strip DOMAIN_NS() wrapper in function prototypes Omokefe Emmanuel Onanaroghene
2026-10-02 4:28 ` Randy Dunlap
2026-10-14 17:22 ` Jonathan Corbet
2026-10-14 22:47 ` Omokefe Emmanuel Onanaroghene
2026-10-15 0:53 ` Omokefe Emmanuel Onanaroghene
2026-10-15 13:00 ` Jonathan Corbet
2026-10-15 16:44 ` [PATCH v3 0/2] docs: kdoc: fix TRACE_EVENT_FN and DOMAIN_NS parsing Omokefe Emmanuel Onanaroghene
2026-10-15 16:44 ` [PATCH v3 1/2] docs: kdoc: handle TRACE_EVENT_FN() family in tracepoint parser Omokefe Emmanuel Onanaroghene
2026-10-15 17:06 ` Mauro Carvalho Chehab
2026-10-16 20:43 ` [PATCH] " Omokefe Emmanuel Onanaroghene
2026-10-16 21:11 ` Mauro Carvalho Chehab
2026-10-23 13:04 ` Omokefe Emmanuel Onanaroghene [this message]
2026-10-23 13:04 ` [PATCH v2 1/2] docs: kdoc: handle nested commas in CMatch arguments Omokefe Emmanuel Onanaroghene
2026-10-23 13:04 ` [PATCH v2 2/2] docs: kdoc: handle TRACE_EVENT_FN() with CMatch Omokefe Emmanuel Onanaroghene
2026-10-15 16:44 ` [PATCH v3 2/2] docs: kdoc: strip DOMAIN_NS() wrapper in function prototypes Omokefe Emmanuel Onanaroghene
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261023130444.26270-1-emmaonana18@gmail.com \
--to=emmaonana18@gmail.com \
--cc=Julia.Lawall@inria.fr \
--cc=corbet@lwn.net \
--cc=gary@garyguo.net \
--cc=hemanth.selam@gmail.com \
--cc=linusw@kernel.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mchehab+huawei@kernel.org \
--cc=mchehab@kernel.org \
--cc=paulmck@kernel.org \
--cc=rdunlap@infradead.org \
--cc=rmk+kernel@armlinux.org.uk \
--cc=skhan@linuxfoundation.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®