docs: kdoc: emit a warning for ancient versions of Python
authorJonathan Corbet <corbet@lwn.net>
Thu, 10 Jul 2025 23:24:07 +0000 (17:24 -0600)
committerJonathan Corbet <corbet@lwn.net>
Tue, 15 Jul 2025 19:43:30 +0000 (13:43 -0600)
commit40020fe8e3a4038ed6fb4b3115ad4c60fd354ab3
tree05d6a0f9d667d68643dd7232879e7379b65c279f
parent636d4d9ec641025b98e8df4623a77ecc09026209
docs: kdoc: emit a warning for ancient versions of Python

Versions of Python prior to 3.7 do not guarantee to remember the insertion
order of dicts; since kernel-doc depends on that guarantee, running with
such older versions could result in output with reordered sections.

Python 3.9 is the minimum for the kernel as a whole, so this should not be
a problem, but put in a warning just in case somebody tries to use
something older.

Suggested-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
scripts/lib/kdoc/kdoc_parser.py