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

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

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 david.k.l...@gmail.com 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

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 fij...@gmail.com wrote: On Mon, Apr 15, 2013 at 9:56 AM, David Lam david.k.l...@gmail.com 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

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 ncogh...@gmail.com wrote: On Mon, Apr 15, 2013 at 8:17 PM, Maciej Fijalkowski fij...@gmail.com wrote: On Mon, Apr 15, 2013 at 9:56 AM, David Lam david.k.l...@gmail.com wrote: I tried to find an example in the source which addressed this, but

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 eli...@gmail.com wrote: On Mon, Apr 15, 2013 at 3:45 AM, Nick Coghlan ncogh...@gmail.com wrote: On Mon, Apr 15, 2013 at 8:17 PM, Maciej Fijalkowski fij...@gmail.com wrote: On Mon, Apr 15, 2013 at 9:56 AM, David Lam david.k.l...@gmail.com wrote: I

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 altogether

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 david.k.l...@gmail.com 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

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

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