[issue8172] Documentation of Property needs example

[Mitchell Model]

New submission from Mitchell Model <mlm at acm.org>:

Strangely, the extensive documentation of the property function in the "Built-in Functions" of the documentation has no example of the use of a property. Readers unfamiliar with properties should be told that obj.x invokes the getter, obj.x=value the setter, etc. The lack of parentheses is particularly significant.

----------
assignee: georg.brandl
components: Documentation
messages: 101262
nosy: MLModel, georg.brandl
severity: normal
status: open
title: Documentation of Property needs example
versions: Python 2.5, Python 2.6, Python 2.7, Python 3.1, Python 3.2

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue8172>
_______________________________________