I tried to do this before, but gave up when I saw that it was impossible to get rid of PyObject * until we can use :no-typesetting: in Sphinx 7.2. And now it generates also recurring "Part of the Stable ABI" which increases the table height.

until we can use :no-typesetting: in Sphinx 7.2.

We now can! We're using Sphinx 8.2 for 3.12+ (and 7.2 for 3.11):

:no-typesetting: inflates the source table height.
I personally prefer the “real”-looking definitions with PyObject * and stable ABI notes. To me, these are primarily link targets that you jump to from a search. Who'll scroll up to read the introduction?

But, I'm OK with this :no-typesetting: version too.

Is it possible to add space between three tables? Each table has certain order. When they are merged, there is no order.

I think it's only possible with three separate tables, with misaligned columns.
Do you like this better?

I'll go with the “full” info for this PR, then. It can be slimmed down in the future.
An issue is that the Stable ABI notes are autogenerated (so that documentarians don't need to care about them); moving them elsewhere would mean maintaining them manually.

For future reference, I'm attaching screenshots of both variants, and a little script I used to add the :no-typesetting: everywhere, so anyone can easily experiment :)

With “real” definitions -- bigger but more complete:

With :no-typesetting: and :c:var: -- leaner:

filename = 'Doc/c-api/exceptions.rst'

DEFINITION_START = '   * * .. c:var:: PyObject *'

with open(filename) as f:
    lines = list(f)
new_lines = []
for line in lines:
    new_lines.append(line)
    if line.startswith(DEFINITION_START):
        name = line.removeprefix(DEFINITION_START)
        new_lines.append('          :no-typesetting:\n')
        new_lines.append('\n')
        new_lines.append(f'       :c:var:`!{name.strip()}`\n')


with open(filename, 'w') as f:
    f.writelines(new_lines)

Thanks @encukou for the PR 🌮🎉.. I'm working now to backport this PR to: 3.13.
🐍🍒⛏🤖

Thanks @encukou for the PR 🌮🎉.. I'm working now to backport this PR to: 3.14.
🐍🍒⛏🤖

GH-136503 is a backport of this pull request to the 3.13 branch.

GH-136504 is a backport of this pull request to the 3.14 branch.