From: Jonathan Corbet <corbet@lwn.net>
Date: Mon, 10 Feb 2025 18:28:12 +0000 (-0700)
Subject: Merge branch 'mauro' into docs-mw
X-Git-Tag: v6.15-rc1~223^2~48
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=1ce8294cfefb968aabefbf888d0a66af624622e8;p=thirdparty%2Flinux.git

Merge branch 'mauro' into docs-mw

Mauro says:

This series replace get_abi.pl with a Python version.

I originally started it due to some issues I noticed when searching for
ABI symbols. While I could just go ahead and fix the already existing
script, I noticed that the script maintainance didn't have much care over
all those years, probably because it is easier to find Python programmers
those days.

Also, the code is complex and was not using modules or classes and
were using lots of global variables.

So, I decided to rewrite it in Python. I started with a manual conversion
for each function. Yet, to avoid future maintainership issues, I opted to
divide the main code on three classes, each on a sepaparate file.

Just like the original RFC, I opted to keep the Sphinx kernel-abi module
on three different phases:

- call get_abi.py as an exec file;
- import AbiParser on a minimal integration scenario;
- cleanup the code to avoid needing to parse line numbers from the text.

This way, if something goes wrong, it would be easier to just revert any
offending patches, It also provides a better rationale about what each
logical change is doing.

The initial patches on this series do some preparation work and
cleans some ABI symbol bugs that lack ":" delimiter.
---

1ce8294cfefb968aabefbf888d0a66af624622e8