[docs] [issue34394] Descriptors HowTo doesn't mention __set_name__

Semyon report at bugs.python.org
Mon Aug 13 08:36:26 EDT 2018

New submission from Semyon <simeon+bpo at maryasin.name>:

There is a great HowTo document for descriptors https://github.com/python/cpython/blob/master/Doc/howto/descriptor.rst
But it doesn't even mention the __set_name__ method which was added in py3. And it lists the descriptor protocol without that method as if it is the full protocol. The only way to know about that method is to go to the link for any other method and then you'll see that there is a __set_name__.
I think the guide sholud be updated to include at least information about existence of __set_name__.

assignee: docs at python
components: Documentation
messages: 323479
nosy: MarSoft, docs at python
priority: normal
severity: normal
status: open
title: Descriptors HowTo doesn't mention __set_name__
versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

Python tracker <report at bugs.python.org>

More information about the docs mailing list