Re: [Python-Dev] Sharing docstrings between the Python and C implementations of a module

2013-04-16 Thread Stephen J. Turnbull
Skip Montanaro writes: > > Would it make sense to think about adding this in the scope of > > the argument clinic work, or is it too unrelated? This seems like > > a commonly needed thing for large parts of the stdlib (where the > > C accelerator overrides Python code). > > Or maybe separat

Re: [Python-Dev] Sharing docstrings between the Python and C implementations of a module

2013-04-15 Thread Glenn Linderman
On 4/15/2013 4:21 PM, Larry Hastings wrote: On 04/15/2013 09:31 AM, Eli Bendersky wrote: Would it make sense to think about adding this in the scope of the argument clinic work, or is it too unrelated? This seems like a commonly needed thing for large parts of the stdlib (where the C accelerat

Re: [Python-Dev] Sharing docstrings between the Python and C implementations of a module

2013-04-15 Thread Larry Hastings
On 04/15/2013 09:31 AM, Eli Bendersky wrote: Would it make sense to think about adding this in the scope of the argument clinic work, or is it too unrelated? This seems like a commonly needed thing for large parts of the stdlib (where the C accelerator overrides Python code). From my perspect

Re: [Python-Dev] Sharing docstrings between the Python and C implementations of a module

2013-04-15 Thread Alexandre Vassalotti
On Mon, Apr 15, 2013 at 12:56 AM, David Lam wrote: > I tried to find an example in the source which addressed this, but > found that the docstrings in similar cases to be largely duplicated. > I find this annoying too. It would be nice to have a common way to share docstrings between C and Pytho

Re: [Python-Dev] Sharing docstrings between the Python and C implementations of a module

2013-04-15 Thread Skip Montanaro
> Would it make sense to think about adding this in the scope of the argument > clinic work, or is it too unrelated? This seems like a commonly needed thing > for large parts of the stdlib (where the C accelerator overrides Python > code). Or maybe separate doc strings from both code bases altoget

Re: [Python-Dev] Sharing docstrings between the Python and C implementations of a module

2013-04-15 Thread Joao S. O. Bueno
On 15 April 2013 13:31, Eli Bendersky wrote: > > > > On Mon, Apr 15, 2013 at 3:45 AM, Nick Coghlan wrote: >> >> On Mon, Apr 15, 2013 at 8:17 PM, Maciej Fijalkowski >> wrote: >> > On Mon, Apr 15, 2013 at 9:56 AM, David Lam >> > wrote: >> >> I tried to find an example in the source which addresse

Re: [Python-Dev] Sharing docstrings between the Python and C implementations of a module

2013-04-15 Thread Eli Bendersky
On Mon, Apr 15, 2013 at 3:45 AM, Nick Coghlan wrote: > On Mon, Apr 15, 2013 at 8:17 PM, Maciej Fijalkowski > wrote: > > On Mon, Apr 15, 2013 at 9:56 AM, David Lam > wrote: > >> I tried to find an example in the source which addressed this, but > >> found that the docstrings in similar cases to

Re: [Python-Dev] Sharing docstrings between the Python and C implementations of a module

2013-04-15 Thread Nick Coghlan
On Mon, Apr 15, 2013 at 8:17 PM, Maciej Fijalkowski wrote: > On Mon, Apr 15, 2013 at 9:56 AM, David Lam wrote: >> I tried to find an example in the source which addressed this, but >> found that the docstrings in similar cases to be largely duplicated. >> For instance, _datetimemodule.c, decimal_

Re: [Python-Dev] Sharing docstrings between the Python and C implementations of a module

2013-04-15 Thread Maciej Fijalkowski
On Mon, Apr 15, 2013 at 9:56 AM, David Lam wrote: > Recently I helped out on issue16954 which involved filling in docstrings > for methods and classes in ElementTree.py > > While doing so, I tried to test my work in the interpreter like this... > > >>> from xml.etree.ElementTree import Element

[Python-Dev] Sharing docstrings between the Python and C implementations of a module

2013-04-15 Thread David Lam
Recently I helped out on issue16954 which involved filling in docstrings for methods and classes in ElementTree.py While doing so, I tried to test my work in the interpreter like this... >>> from xml.etree.ElementTree import Element >>> help(Element) ...but found that help() showed nothi