`type('', (), {})__weakref__.__doc__` is inaccurate

[jonathandung]

Documentation

The __weakref__ descriptor on an instance of user-defined classes is a weak reference (singular instance of weakref.ReferenceType, preferring the unique one with no callback passed to the constructor if it exists and the most recently created one if not in case of multiple, and None otherwise. However, it is documented as a "list of weak references to the object".

[ZeroIntensity]

I think the term "list" here is referring to the C-level linked list formed by weakref objects, not a Python list object, but I do see how it could be misinterpreted. We also lack proper documentation for __weakref__ anyway, so I think we should fix that before messing with any docstrings.

[jonathandung]

Should I change the title? I meant to express a user-defined class not inheriting from something special like str

[jonathandung]

I think the term "list" here is referring to the C-level linked list formed by weakref objects, not a Python list object, but I do see how it could be misinterpreted. We also lack proper documentation for __weakref__ anyway, so I think we should fix that before messing with any docstrings.

I see. I had to obtain the basic information above about how weak references are stored on the object by messing around in the REPL, and this is even more foreign to me.