[docs] ElementTree: Document handling processing instructions (issue 20375)

[Nikolaus at rath.org]

Thanks for your feedback! I've attached an updated patch.


http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst
File Doc/library/xml.etree.elementtree.rst (right):

http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst#newcode114
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:
> I think this could be made clearer. Something like "trees built using
this
> module's API rather than parsing from XML test can have comments and
processing
> instructions in them, and are included...."
> 

Done.

http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst#newcode396
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.elementtree.rst#newcode399
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.elementtree.rst#newcode483
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/