I think this could be made clearer. Something like "trees built using

module's API rather than parsing from XML test can have comments and

Thanks for your feedback! I've attached an updated patch. http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.element... File Doc/library/xml.etree.elementtree.rst (right): http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.element... Doc/library/xml.etree.elementtree.rst:114: input. Processing instructions and comments can nevertheless be On 2014/04/02 15:26:31, eli.bendersky wrote: this processing

instructions in them, and are included...."

Done. http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.element... Doc/library/xml.etree.elementtree.rst:396: Note that the element tree XML parser skips over comments in the On 2014/04/02 15:26:31, eli.bendersky wrote:

Replace "the element tree XML parser" with a properly ReST-linked "ElementTree", as done elsewhere in the document.

Done. http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.element... Doc/library/xml.etree.elementtree.rst:399: into to the tree using :meth:`~Element.insert`, On 2014/04/02 15:26:31, eli.bendersky wrote:

I don't think this listing is necessary - there are many ways to create new Element nodes...

Done. http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.element... Doc/library/xml.etree.elementtree.rst:483: instructions in the input instead of creating objects for them. An On 2014/04/02 15:26:31, eli.bendersky wrote:

same comments here as for the previous block.

Done. http://bugs.python.org/review/20375/