Re: [Cython] Autodoc improvements (#216)

2013-05-01 Thread Stefan Behnel
Stefan Behnel, 01.05.2013 11:50: > Nikita Nemkin, 26.04.2013 13:33: >> On Tue, 23 Apr 2013 10:19:15 +0600, Robert Bradshaw wrote: >> >>> Jumping into this thread late, improvements (1) and (3) certainly seem >>> beneficial. As far as documenting "attributes," I can't see much of a >>> use, but the

Re: [Cython] Autodoc improvements (#216)

2013-05-01 Thread Stefan Behnel
Nikita Nemkin, 26.04.2013 13:33: > On Tue, 23 Apr 2013 10:19:15 +0600, Robert Bradshaw wrote: > >> Jumping into this thread late, improvements (1) and (3) certainly seem >> beneficial. As far as documenting "attributes," I can't see much of a >> use, but the downsides seem are low enough (accident

Re: [Cython] Autodoc improvements (#216)

2013-04-26 Thread Nikita Nemkin
On Tue, 23 Apr 2013 10:19:15 +0600, Robert Bradshaw wrote: Jumping into this thread late, improvements (1) and (3) certainly seem beneficial. As far as documenting "attributes," I can't see much of a use, but the downsides seem are low enough (accidentally assigning a stray string to the prev

Re: [Cython] Autodoc improvements (#216)

2013-04-22 Thread Robert Bradshaw
Jumping into this thread late, improvements (1) and (3) certainly seem beneficial. As far as documenting "attributes," I can't see much of a use, but the downsides seem are low enough (accidentally assigning a stray string to the previously declared attribute) and the implementation non-invasive en

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

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 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 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 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