[Python-Dev] __objclass__ documentation

[Ethan Furman]

On 10/12/2013 11:18 PM, Cameron Simpson wrote:
> On 12Oct2013 15:03, Ethan Furman <ethan at stoneleaf.us> wrote:
>> It was pointed in Issue16938[1] that __objclass__ is not documented anywhere.
>>
>> Is the following an appropriate description? (in Doc/reference/datamodel.rst in user-defined functions)
>>        +-------------------------+-------------------------------+-----------+
>>        | :attr:`__objclass__`    | The class this object belongs |           |
>>        |                         | to; useful when the object is |           |
>>        |                         | a descriptor, or a virtual or |           |
>>        |                         | dynamic class attribute, and  |           |
>>        |                         | it's __class__ attribute does |           |
>
> "its" please. Like "his", "her", "their".

Right.

>
>>        |                         | not match the class it is     |           |
>>        |                         | associated with, or it is not |           |
>>        |                         | in that class' ``__dict__``.  |           |
>>        +-------------------------+-------------------------------+-----------+
>> [1] http://bugs.python.org/issue16938
>
> I'd make this two sentences. Just turn the semicolon into a full
> stop, and commence "This is useful when".
>
> I had trouble with the end. How about:
>
>    or it is not in __class__.__dict__
>
> Do I misunderstand?

You have it right.  Good change.

--
~Ethan~