On 5/13/2015 4:10 AM, raymond.hettinger wrote:
> https://hg.python.org/cpython/rev/1e8a768fa0a5
> changeset: 96010:1e8a768fa0a5
> user: Raymond Hettinger <pyt...@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.
_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
https://mail.python.org/mailman/listinfo/python-dev
Unsubscribe:
https://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
