[Python-Dev] __objclass__ documentation

[Cameron Simpson]

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".

>       |                         | 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?

Cheers,
-- 
Cameron Simpson <cs at zip.com.au>

Trust the computer... the computer is your friend.
        - Richard Dominelli <dominel at panix.com>