Do you have a rough idea of when it was working? (2010? 2015? 2020?) I could look at this, but unbounded I fear it'd be a fairly time consuming activity.

Prepending references with~object. is a fairly easy mechanical task, though I appreciate it adds noise. From what I understand of Sphinx though, it does seem the 'proper' thing to do.

Perhaps of interest, this is a table of the frequency of dunder attributes that cause reference warnings (I've filtered a little but not properly):

A

Perhaps it worked 10 years ago. There were more Python specific code in Doc/tools/extensions, and Sphinx itself was more Python-oriented. Or maybe it was just a legend, I don't remember.

It perhaps worked by accident on old Sphinx versions.

LGTM.

@AA-Turner, are you going to create a separate PR for every dunder method? Some lines contain references to several dunder methods (for example__getitem__,__iter__,__len__,__setitem__). The same line can be modified several times in a series of PRs. It will make reading history more difficult. Why not merge changes for several related methods in one PR?

Thanks@AA-Turner for the PR, and@hugovk for merging it 🌮🎉.. I'm working now to backport this PR to: 3.11, 3.12.
🐍🍒⛏🤖

GH-111073 is a backport of this pull request to the3.12 branch.

GH-111074 is a backport of this pull request to the3.11 branch.