[3.12] gh-93607: document root attribute of iterparse (GH-99410) (#111555)

Co-authored-by: Prometheus3375 <[email protected]>
Co-authored-by: Stanley <[email protected]>
Co-authored-by: Hugo van Kemenade <[email protected]>

Author: 4 people

Doc/library/xml.etree.elementtree.rst

@@ -622,7 +622,9 @@ Functions
    *parser* is an optional parser instance.  If not given, the standard
    :class:`XMLParser` parser is used.  *parser* must be a subclass of
    :class:`XMLParser` and can only use the default :class:`TreeBuilder` as a
-   target.  Returns an :term:`iterator` providing ``(event, elem)`` pairs.
+   target. Returns an :term:`iterator` providing ``(event, elem)`` pairs;
+   it has a ``root`` attribute that references the root element of the
+   resulting XML tree once *source* is fully read.
 
    Note that while :func:`iterparse` builds the tree incrementally, it issues
    blocking reads on *source* (or the file it names).  As such, it's unsuitable