diff options
| author | Eli Bendersky <eliben@gmail.com> | 2012-10-09 06:46:33 -0700 |
|---|---|---|
| committer | Eli Bendersky <eliben@gmail.com> | 2012-10-09 06:46:33 -0700 |
| commit | 323a43af0639883220227424e6aee474bfde55f7 (patch) | |
| tree | b181bd74b69109cbad9896d6f9b67f34a9ca184c | |
| parent | ea69bd3ce14a776be0a64e32d45a3ee60d91210a (diff) | |
| download | cpython-git-323a43af0639883220227424e6aee474bfde55f7.tar.gz | |
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.
| -rw-r--r-- | Doc/library/xml.etree.elementtree.rst | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst index 16bb00c1e5..cd4a4900fd 100644 --- a/Doc/library/xml.etree.elementtree.rst +++ b/Doc/library/xml.etree.elementtree.rst @@ -291,7 +291,9 @@ Supported XPath syntax | | current element. For example, ``.//egg`` selects | | | 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. | +-----------------------+------------------------------------------------------+ @@ -521,7 +523,7 @@ Element Objects .. method:: clear() 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) |