# HG changeset patch
# Parent 466c5119a2565ac3007d113202e259e6cc81ce41

diff -r 466c5119a256 Doc/library/xml.etree.elementtree.rst
--- a/Doc/library/xml.etree.elementtree.rst	Fri May 29 18:44:50 2015 -0500
+++ b/Doc/library/xml.etree.elementtree.rst	Wed Jun 03 13:33:14 2015 +0000
@@ -651,21 +651,21 @@
 
 
    .. attribute:: text
+                  tail
 
-      The *text* attribute can be used to hold additional data associated with
-      the element.  As the name implies this attribute is usually a string but
-      may be any application-specific object.  If the element is created from
-      an XML file the attribute will contain any text found between the element
-      tags.
+      The *text* attribute holds either the text between the element's
+      start tag and its first child or end tag, or ``None``.  The *tail*
+      attribute holds either the text between the element's end tag and
+      the next tag, or ``None``.  For ``<a><b>1<c>2<d/>3</c></b>4</a>``
+      xml data, the *a* element has ``None`` for both *text* and
+      *tail* attributes, the *b* element has *text* ``"1"`` and *tail*
+      ``"4"``, the *c* element has *text* ``"2"`` and *tail* ``None``,
+      the *d* element has *text* ``None`` and *tail* ``"3"``.
 
+      To collect the inner text of an element, see :meth:`itertext`, for
+      example ``"".join(element.itertext())``.
 
-   .. attribute:: tail
-
-      The *tail* attribute can be used to hold additional data associated with
-      the element.  This attribute is usually a string but may be any
-      application-specific object.  If the element is created from an XML file
-      the attribute will contain any text found after the element's end tag and
-      before the next tag.
+      Applications may store arbitrary objects in these attributes.
 
 
    .. attribute:: attrib