[Python-Dev] [Python-checkins] cpython: Issue #24064: Property() docstrings are now writeable. (original) (raw)

Eric V. Smith eric at trueblade.com
Wed May 13 10:56:55 CEST 2015


On 5/13/2015 4:10 AM, raymond.hettinger wrote:

https://hg.python.org/cpython/rev/1e8a768fa0a5 changeset: 96010:1e8a768fa0a5 user: Raymond Hettinger <python at rcn.com> date: Wed May 13 01:09:59 2015 -0700 summary: 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_ +fields: + + >>> 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 = ... etc.?

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

Eric.



More information about the Python-Dev mailing list