diff -r 3191da5c3726 Doc/library/xml.etree.elementtree.rst
--- a/Doc/library/xml.etree.elementtree.rst	Tue Jul 20 01:17:22 2010 +0200
+++ b/Doc/library/xml.etree.elementtree.rst	Mon Jul 19 22:28:55 2010 -0500
@@ -412,6 +412,38 @@
       getroot().findall(match).  *match* may be a tag name or path.  Returns a
       list containing all matching elements, in document order.
 
+    Example of some of the allowed paths for find and findall:
+
+    >>> import xml.etree.ElementTree
+    >>> exampleXml = """
+    ... <impls>
+    ...   <cpython>
+    ...     <versions>
+    ...       <version>2.7</version>
+    ...       <version stable="yes">3.2</version>    
+    ...       <version stable="no">3.3</version>
+    ...     </versions>
+    ...   </cpython>
+    ...   <jython>
+    ...     <versions>
+    ...       <version>2.5</version>
+    ...     </versions>
+    ...   </jython>
+    ... </impls>
+    ... """
+    >>> tree = xml.etree.ElementTree.fromstring(exampleXml)
+    >>> vs = tree.findall("*//version") # Finds all occurences of version tags
+    >>> len(vs)
+    4
+    >>> tree.findall("cpython/*/version") # Finds all occurences of version tags that are grandchildren of cpython
+    [<Element 'version' at 0x7fdc2ea38610>, <Element 'version' at 0x7fdc2ea38650>, <Element 'version' at 0x7fdc2ea38690>]
+    >>> tree.findall("cpython/versions/version[1]") # Finds the second occurence of version tag under cpython
+    [<Element 'version' at 0x7fdc2ea38610>]
+    >>> tree.findall("*//version[@stable]") # Finds all occurrences of version tags with stable attributes
+    [<Element 'version' at 0x7fdc2ea38650>, <Element 'version' at 0x7fdc2ea38690>]
+    >>> tree.findall("*//version[@stable='yes']") # Finds all occurrences of version tags with stable attributes with values of yes
+    [<Element 'version' at 0x7fdc2ea38650>]
+
 
    .. method:: findtext(match, default=None)