[issue22174] property doc fixes

Raymond Hettinger added the comment: Diana, thank you for the patch. Sorry for the bogus comment on whitespace. I was looking the the docstring at the same time as reviewing the patch. David, thanks for looking at it as well. -- resolution: -> fixed stage: -> resolved status: open -

[issue22174] property doc fixes

Roundup Robot added the comment: New changeset 98a2e215ff01 by Raymond Hettinger in branch '2.7': Issue #22174: Clean-up grammar and ambiguities in property() docs. http://hg.python.org/cpython/rev/98a2e215ff01 -- ___ Python tracker

[issue22174] property doc fixes

Roundup Robot added the comment: New changeset ebd6f7f7859f by Raymond Hettinger in branch '3.4': Issue #22174: Clean-up grammar and ambiguities in property() docs. http://hg.python.org/cpython/rev/ebd6f7f7859f -- nosy: +python-dev ___ Python tracker

[issue22174] property doc fixes

Raymond Hettinger added the comment: Most of the patch looks to be an improvement. I've massaged it a little and attached a revised patch. -- Added file: http://bugs.python.org/file36332/property2.diff ___ Python tracker

[issue22174] property doc fixes

Changes by Raymond Hettinger : -- Removed message: http://bugs.python.org/msg225123 ___ Python tracker ___ ___ Python-bugs-list mailin

[issue22174] property doc fixes

diana added the comment: This whitespace? Or did you mean something else? class C: def __init__(self): self._x = None def getx(self): return self._x def setx(self, value): self._x = value def delx(self):

[issue22174] property doc fixes

Raymond Hettinger added the comment: Also, please don't add the extra whitespace to the docstring. It is intentionally compact because of the differing needs of various IDEs and help utlities. -- assignee: docs@python -> rhettinger nosy: +rhettinger __

[issue22174] property doc fixes

R. David Murray added the comment: The docstring discussion is correct in the context. property can easily be used to create a read only property because when used as a decorator the function that follows the decorator call is passed to it as fget, *and it copies the docstring from the functi

[issue22174] property doc fixes

Changes by diana : Added file: http://bugs.python.org/file36319/Screen Shot 2014-08-08 at 4.44.07 PM.png ___ Python tracker ___ ___ Python-bu

[issue22174] property doc fixes

New submission from diana: The property docs are a bit funky. https://docs.python.org/3/library/functions.html#property 1) docstrings have zero to do with making a read-only property. It currently says: "If given, doc will be the docstring of the property attribute. Otherwise, the proper