Roundup Robot devn...@psf.upfronthosting.co.za added the comment:
New changeset e38f4cf482c7 by Eli Bendersky in branch 'default':
Issue #6488: Explain the XPath support of xml.etree.ElementTree, with code
http://hg.python.org/cpython/rev/e38f4cf482c7
--
nosy: +python-dev
Changes by Eli Bendersky eli...@gmail.com:
--
resolution: - fixed
stage: needs patch - committed/rejected
status: open - closed
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue6488
___
Eli Bendersky eli...@gmail.com added the comment:
Closing the issue, unless someone wants to back-port this to 3.2/2.7
--
nosy: +eli.bendersky
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue6488
Florent Xicluna florent.xicl...@gmail.com added the comment:
Documentation patch accepted, for the path == XPath confusion and clarify
other points too.
http://bugs.python.org/issue6488#msg90528
--
assignee: effbot -
type: - behavior
___
Python
Florent Xicluna florent.xicl...@gmail.com added the comment:
See also patch attached to #2864 which proposes to add an XPath example to the
documentation.
--
nosy: +guettli, littlemog, mbone
___
Python tracker rep...@bugs.python.org
Fredrik Lundh fred...@effbot.org added the comment:
As per PEP 257, “Returns” should become “Return” (it’s a command, not a
description).
Upstream ET uses JavaDoc conventions, where the conventions are
designed by technical writers, not hackers. In JavaDoc, descriptions
are 3rd person
Fredrik Lundh fred...@effbot.org added the comment:
The missing/extra words in the findtext description is just a case of sloppy
copy-editing, most likely after a quick reformatting. Not sure why you're
spending all this energy arguing about commas, though.
--
Jason R. Coombs jar...@jaraco.com added the comment:
I agree. I found the documentation very difficult to understand. The term
top-level can be confusing. Consider instead something like search the
entire tree.
A few other comments about the documentation of findtext:
findtext(path[,
Changes by Florent Xicluna florent.xicl...@gmail.com:
--
components: +XML
stage: - needs patch
versions: -Python 3.0
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue6488
___
Changes by Florent Xicluna florent.xicl...@gmail.com:
--
nosy: +flox
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue6488
___
___
Python-bugs-list
R. David Murray rdmur...@bitdance.com added the comment:
I think you are incorrect about the comma after element. Without the comma
'the first matching element or the default value' are tightly bound, meaning
that if either of those is true, then the default value is returned. That's
New submission from Mitchell Model m...@acm.org:
The documentation of ElementTree mentions path in describing the
arguments to certain methods. However, path is never defined. I
realize that a path is (at least a partial implementation of) an
XPath, but there's nothing in the documentation to
Changes by Ezio Melotti ezio.melo...@gmail.com:
--
assignee: georg.brandl - effbot
nosy: +effbot
priority: - low
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue6488
___
13 matches
Mail list logo