Re: [Cython] [cython] Autodoc improvements (#216)

2013-04-20 Thread Nikita Nemkin
On Sat, 20 Apr 2013 02:11:21 +0600, Stefan Behnel wrote: Nikita Nemkin, 18.04.2013 07:07: 2) Public/readonly cdef attributes can have docstrings attached, using the [PEP 258 attribute docstring syntax](http://www.python.org/dev/peps/pep-0258/#attribute-docstrings). Example: cdef cla

Re: [Cython] Autodoc improvements (#216)

2013-04-20 Thread Stefan Behnel
Nikita Nemkin, 20.04.2013 09:11: > On Sat, 20 Apr 2013 02:11:21 +0600, Stefan Behnel wrote: >> Nikita Nemkin, 18.04.2013 07:07: >>> 2) Public/readonly cdef attributes can have docstrings attached, using >>> the [PEP 258 attribute docstring >>> syntax](http://www.python.org/dev/peps/pep-0258/#attrib

Re: [Cython] Autodoc improvements (#216)

2013-04-20 Thread Nikita Nemkin
On Sat, 20 Apr 2013 14:27:12 +0600, Stefan Behnel wrote: Nikita Nemkin, 20.04.2013 09:11: On Sat, 20 Apr 2013 02:11:21 +0600, Stefan Behnel wrote: Separating property from the attribute requires mass renaming of the attribute (as was recently descussed here) and bloating the code x4. All thi

Re: [Cython] Autodoc improvements (#216)

2013-04-20 Thread Stefan Behnel
Nikita Nemkin, 20.04.2013 12:43: > On Sat, 20 Apr 2013 14:27:12 +0600, Stefan Behnel wrote: >> Nikita Nemkin, 20.04.2013 09:11: >>> On Sat, 20 Apr 2013 02:11:21 +0600, Stefan Behnel wrote: >>> Separating property from the attribute requires mass renaming of >>> the attribute (as was recently descus

Re: [Cython] Autodoc improvements (#216)

2013-04-20 Thread Nikita Nemkin
On Sat, 20 Apr 2013 17:41:56 +0600, Stefan Behnel wrote: Nikita Nemkin, 20.04.2013 12:43: On Sat, 20 Apr 2013 14:27:12 +0600, Stefan Behnel wrote: I did document them manually at first. It is ugly (function doc in one place, attribute doc in another) As it should be. The attributes are

Re: [Cython] Autodoc improvements (#216)

2013-04-20 Thread Stefan Behnel
Nikita Nemkin, 20.04.2013 16:44: > On Sat, 20 Apr 2013 17:41:56 +0600, Stefan Behnel wrote: >> Nikita Nemkin, 20.04.2013 12:43: >>> On Sat, 20 Apr 2013 14:27:12 +0600, Stefan Behnel wrote: >>> I did document them manually at first. It is ugly (function doc in one >>> place, attribute doc in another