Re: [Python-Dev] cpython: Cleanup the docs ElementTree a bit and describe the default_namespace

2013-01-13 Thread Serhiy Storchaka

On 13.01.13 16:28, eli.bendersky wrote:

http://hg.python.org/cpython/rev/f0e80c7404a5
changeset:   81490:f0e80c7404a5
user:Eli Bendersky eli...@gmail.com
date:Sun Jan 13 06:27:51 2013 -0800
summary:
   Cleanup the docs ElementTree a bit and describe the default_namespace 
parameter. In the code, replace the old outdated Doxygen-ish comment above 
ElementTree.write by a proper docstring.


I think that wrong documentation of ElementTree.write is a bug and 
should be fixed in early Python versions too.



___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] cpython: Cleanup the docs ElementTree a bit and describe the default_namespace

2013-01-13 Thread Serhiy Storchaka
And perhaps it will be better if parameters will be described in same 
order as they enumerated in the signature (now 'default_namespace' 
described after 'method').


___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] cpython: Cleanup the docs ElementTree a bit and describe the default_namespace

2013-01-13 Thread Eli Bendersky
On Sun, Jan 13, 2013 at 7:31 AM, Serhiy Storchaka storch...@gmail.comwrote:

 And perhaps it will be better if parameters will be described in same
 order as they enumerated in the signature (now 'default_namespace'
 described after 'method').



Serhiy, both you comments make sense. But:

1. A better place to park them is an issue (the original issue for which
the commits were made, or even a new issue).
2. Feel free to use your newly gained superpowers to help out with such
fixes. Often a quick fix + commit doesn't take much longer than to write an
email.

Eli





 __**_
 Python-Dev mailing list
 Python-Dev@python.org
 http://mail.python.org/**mailman/listinfo/python-devhttp://mail.python.org/mailman/listinfo/python-dev
 Unsubscribe: http://mail.python.org/**mailman/options/python-dev/**
 eliben%40gmail.comhttp://mail.python.org/mailman/options/python-dev/eliben%40gmail.com

___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] cpython: Cleanup the docs ElementTree a bit and describe the default_namespace

2013-01-13 Thread Serhiy Storchaka

On 13.01.13 19:28, Eli Bendersky wrote:

1. A better place to park them is an issue (the original issue for
which the commits were made, or even a new issue).


I agree. Usually I do this, except for the cases when the issue number 
is not specified in the commit message.



2. Feel free to use your newly gained superpowers to help out with such
fixes. Often a quick fix + commit doesn't take much longer than to write
an email.


I didn't want to come in your heels. Now, when you have approved it and 
left it for me, I'll do it.


___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com