mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-02 08:02:56 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

Issue #12322: clarify xpath reference for cases where the path reaches ancestors of the start element. Also add missing markup for a None. Thanks to patrick vrijlandt and Mike Hoy for the report and initial patches.

Browse source
This commit is contained in:
Eli Bendersky 2012-10-09 06:46:33 -07:00
parent ea69bd3ce1
commit 323a43af06
1 changed files with 4 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

6
Doc/library/xml.etree.elementtree.rst
View file

@ -291,7 +291,9 @@ Supported XPath syntax
| | current element. For example, ``.//egg`` selects | | | current element. For example, ``.//egg`` selects |
| | all ``egg`` elements in the entire tree. | | | all ``egg`` elements in the entire tree. |
+-----------------------+------------------------------------------------------+ +-----------------------+------------------------------------------------------+
| ``..`` | Selects the parent element. | | ``..`` | Selects the parent element. Returns ``None`` if the |
| | path attempts to reach the ancestors of the start |
| | element (the element ``find`` was called on). |
+-----------------------+------------------------------------------------------+ +-----------------------+------------------------------------------------------+
| ``[@attrib]`` | Selects all elements that have the given attribute. | | ``[@attrib]`` | Selects all elements that have the given attribute. |
+-----------------------+------------------------------------------------------+ +-----------------------+------------------------------------------------------+
@ -521,7 +523,7 @@ Element Objects
.. method:: clear() .. method:: clear()
Resets an element. This function removes all subelements, clears all Resets an element. This function removes all subelements, clears all
attributes, and sets the text and tail attributes to None. attributes, and sets the text and tail attributes to ``None``.
.. method:: get(key, default=None) .. method:: get(key, default=None)