[Python-Dev] [Python-checkins] cpython: Issue #24064: Property() docstrings are now writeable.
berker.peksag at gmail.com
Wed May 13 11:18:22 CEST 2015
On Wed, May 13, 2015 at 11:56 AM, Eric V. Smith <eric at trueblade.com> wrote:
> On 5/13/2015 4:10 AM, raymond.hettinger wrote:
>> changeset: 96010:1e8a768fa0a5
>> user: Raymond Hettinger <python at rcn.com>
>> date: Wed May 13 01:09:59 2015 -0700
>> Issue #24064: Property() docstrings are now writeable.
>> (Patch by Berker Peksag.)
>> diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
>> --- a/Doc/library/collections.rst
>> +++ b/Doc/library/collections.rst
>> @@ -924,6 +924,15 @@
>> >>> Point3D = namedtuple('Point3D', Point._fields + ('z',))
>> +Docstrings can be customized by making direct assignments to the ``__doc__``
>> + >>> Book = namedtuple('Book', ['id', 'title', 'authors'])
>> + >>> Book.__doc__ = 'Hardcover book in active collection'
>> + >>> Book.id = '13-digit ISBN'
>> + >>> Book.title = 'Title of first printing'
>> + >>> Book.author = 'List of authors sorted by last name'
> Should these be:
> Book.id.__doc__ = ...
Good catch. Fixed in https://hg.python.org/cpython/rev/bde652ae05fd
>> + Point = namedtuple('Point', ['x', 'y'])
>> + Point.__doc__ = 'ordered pair'
>> + Point.x.__doc__ = 'abscissa'
>> + Point.y.__doc__ = 'ordinate'
> These lines from /Doc/whatsnew/3.5.rst would make me think so.
> Python-Dev mailing list
> Python-Dev at python.org
> Unsubscribe: https://mail.python.org/mailman/options/python-dev/berker.peksag%40gmail.com
More information about the Python-Dev