Hi Jon, It follows the second version of this small series. It contains missing patches from the python backward-compatibility series. I dropped support for 2.7 and did some changes at changes.rst per Akira's request. They're not urgent, IMO it should be OK to have them merged for 6.17. The first patch ensures that kernel-doc won't crash with version 3.2 (tested on 3.4, as 3.2 is like an unicorn: docker containers v1 don't run anymore on Fedora, building is broken since at least Fedora 32, Anaconda doesn't have it anymore). With this change, on elder versions, it would emit a warning and do nothing, as the actual code depends on features at 3.6 (f-strings) and 3.7 (ordered dict). The second patch changes process/changes.rst. Currently, it makes one think that Python is optional. While not having python may work on some cases, it breaks on arm/arm64 with defconfigs. It also breaks with allyesconfig/almodconfig (at least on x86/x86_64), with clang (on some archs) and apparently on some other subsystems that I didn't care enough to identify, as for me, breaking on arm/arm64 with defconfigs, and on x86/x86_64 with allyesconfig/allmodconfig is enough evidence that this is mandatory nowadays. So, remove optional from Python and add a quick description about where it is required, leaving it open to one's imagination that it could break with other configs we didn't map. --- v2: drop support for 2.7, updated a comment and updated changes.rst. Mauro Carvalho Chehab (2): docs: kernel-doc: avoid script crash on ancient Python docs: changes: better document Python needs Documentation/process/changes.rst | 9 +++++++- scripts/kernel-doc.py | 34 ++++++++++++++++++++++--------- 2 files changed, 32 insertions(+), 11 deletions(-) -- 2.49.0
