Currently __objclass__ is only documented in a ten-year old PEP.

The proposed text is something along the lines of:

__objclass__: 1) Indicates this callable requires an instance of the given type (or a subclass) as its first positional argument; e.g. CPython sets this for unbound methods that are implemented in C rather than Python.  2) The class where this object was defined.

So, any ideas for improvement, and, more importantly, where in the docs should this go?

Changing the order a bit, perhaps something like this in the data model section:

__objclass__: Interpreted by the inspect module as specifying the class where this object was defined (setting this appropriately can assist in runtime introspection of dynamic class attributes). For callables, may indicate that an instance of the given type (or a subclass) is expected or required as the first positional argument (for example, CPython sets this for unbound methods that are implemented in C rather than being normal Python functions).

Perhaps with a cross-reference from the classification function in inspect?

Should we commit this in 3.4?

Huh, I thought we did this back when Ethan was working on enum stuff, but I guess we never figured out exactly where to put it.

Considering that question again now, I suggest adding it to the end of the subsection on implementing descriptors, since that's when it is most likely to be relevant:

http://docs.python.org/dev/reference/datamodel.html#implementing-descriptors

I added __objclass__ to the datamodel section. Patch is submitted for the same. Can you clarify about the link to be provided from this section? I couldn't find the classification function in Documentation.

Thanks for the patch.  Could you make sure the text wraps at 80 characters?

I think Nick was referring to this function: http://docs.python.org/3.4/library/inspect#inspect.ismethod

New changeset 0973d45197cc by Yury Selivanov in branch '3.4':
docs: Document __objclass__. Closes #19281.
http://hg.python.org/cpython/rev/0973d45197cc

New changeset 2a953cb5642d by Yury Selivanov in branch 'default':
docs: Document __objclass__. Closes #19281.
http://hg.python.org/cpython/rev/2a953cb5642d

New changeset 372b19005011 by Yury Selivanov in branch '3.4':
docs: Better wording for __objclass__ docs. Issue #19281
http://hg.python.org/cpython/rev/372b19005011

New changeset febd63a7e927 by Yury Selivanov in branch 'default':
docs: Better wording for __objclass__ docs. Issue #19281
http://hg.python.org/cpython/rev/febd63a7e927