[3.11] gh-102304: doc: Add links to Stable ABI and Limited C API (#105345) (#105371)

[AA-Turner]

• Move _Py_RefTotal to PyInterpreterState #102304: doc: Add links to Stable ABI and Limited C API (gh-102304: doc: Add links to Stable ABI and Limited C API #105345)

• Add "limited-c-api" and "stable-api" references.

• Rename "stable-abi-list" reference to "limited-api-list".

• Makefile: Document files regenerated by "make regen-limited-abi"

• Remove first empty line in generated files:

  • Lib/test/test_stable_abi_ctypes.py
  • PC/python3dll.c

(cherry picked from commit bae415a)

• Move _Py_RefTotal to PyInterpreterState #102304: Fix up Simple ABI doc (gh-102304: Enhance Simple ABI doc #105351)

(cherry picked from commit 0202aa0) (cherry picked from commit 82ab13c)

---

These targets were added for 3.13 and 3.12, but they're needed for the devguide: python/devguide#1167

A

---

📚 Documentation preview 📚: https://cpython-previews--109901.org.readthedocs.build/

[erlend-aasland]

Unfortunately, bae415a does a lot of things:

• doc updates
• C source updates
• script updates

AFAICS, only the doc updates are relevant for python/devguide#1167? @vstinner, should the whole commit be backported, or only parts of it?

[vstinner]

It's up to you, I don't know. I understood that the doc should look the same in all branches: all doc changes should be backported.

[AA-Turner]

should the whole commit be backported, or only parts of it?

I'd intended to only backport the documentation changes; something went wrong in preparing this PR. But if we want to backport everything happy to update the PR, I just wanted to err on the cautious side.

A

[erlend-aasland]

It's up to you, I don't know. I understood that the doc should look the same in all branches: all doc changes should be backported.

The problem is that the original commit is not a doc change; it changes a lot of non-doc stuff.

[erlend-aasland]

@AA-Turner, could you write comment that sums up this change (for the merge commit message)?

[AA-Turner]

First draft:

---

Add links to the Stable ABI and Limited C API

• Add "limited-c-api" and "stable-api" targets
• Rename the "stable-abi-list" target to "limited-api-list"

---

A

[vstinner]

LGTM

[erlend-aasland]

First draft:

Looks ok to me!