[docs] [issue35151] Python 2 xml.etree.ElementTree documentation tutorial uses undocumented arguments

Joshua Honeycutt report at bugs.python.org
Fri Nov 2 20:20:18 EDT 2018


New submission from Joshua Honeycutt <joshua.honeycutt at gmail.com>:

In python 2 documentation 19.7.1.6
(https://docs.python.org/2/library/xml.etree.elementtree.html#parsing-xml-with-namespaces)
a second argument (ns) is passed to find and findall.

However 19.7.3.2 
(https://docs.python.org/2/library/xml.etree.elementtree.html#xml.etree.ElementTree.Element.find)
only specifies the single match argument.

If we compare the python 3 documentation the namespaces argument is included in the find method. (https://docs.python.org/3/library/xml.etree.elementtree.html#xml.etree.ElementTree.Element.find)

Maybe the tutorial was created for python 3 version? I assume the function arguments are automatically generated, but I have not tested or tried these functions in python 2. I just stumbled on the docs while working with python 3.

----------
assignee: docs at python
components: Documentation
messages: 329174
nosy: docs at python, epakai
priority: normal
severity: normal
status: open
title: Python 2 xml.etree.ElementTree documentation tutorial uses undocumented arguments
versions: Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35151>
_______________________________________


More information about the docs mailing list