On Fri, Dec 06, 2013 at 07:28:57AM +0100, Gregory Salvan wrote:
> Hi,
> maybe a syntax like that can correspond:
>
> class MyObject(metaclass=ObjectSpec):
> ''' MyObject doc'''
> 'attr1 contains something'
> attr1 = None
> 'attr2 contains something'
> attr2 = str
> 'method1
We might adopt the conventions promoted by the Sphinx autodoc extension:
http://sphinx-doc.org/ext/autodoc.html#directive-autofunction
Example:
class Foo:
"""Docstring for class Foo."""
#: Doc comment for class attribute Foo.bar.
#: It can have multiple lines.
bar = 1
flox =
ACTIVITY SUMMARY (2013-11-29 - 2013-12-06)
Python tracker at http://bugs.python.org/
To view or respond to any of the issues listed below, click on the issue.
Do NOT respond to this message.
Issues counts and deltas:
open4323 ( +6)
closed 27359 (+70)
total 31682 (+76)
Open issues wit
On 12/6/2013 5:46 AM, Steven D'Aprano wrote:
On Fri, Dec 06, 2013 at 07:28:57AM +0100, Gregory Salvan wrote:
class MyObject(metaclass=ObjectSpec):
''' MyObject doc'''
'attr1 contains something'
attr1 = None
'attr2 contains something'
attr2 = str
'method1 do someth
Reply-To set to python-id...@python.org.
Terry Reedy writes:
> For data attributes, which are usually mutable, it should be attached to
> the attribute *concept*, which is represented by the name, rather than
> the current but usually changeable value. Values are usually already
> document
