This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ned.deily
Recipients docs@python, eli.bendersky, jlaurens, martin.panter, ned.deily, rhettinger, scoder
Date 2015-07-31.07:17:16
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1438327037.07.0.810373316103.issue24079@psf.upfronthosting.co.za>
In-reply-to
Content
I note that the current wording for both "text" and "tail" are careful to allow for the most general use of the Element class, that is, that it may be used in non-XML contexts, for example:

"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 proposed patch downplays that generality.  How about modifying the original wording so that the description starts something like:

"These attributes can be used to hold additional [...] application-specific object.  If the element is created from an XML file, the *text* attribute holds either the text between the element'sstart tag and its first child or end tag, or ``None``and the *tail* attribute holds either the text [...]."
History
Date User Action Args
2015-07-31 07:17:17ned.deilysetrecipients: + ned.deily, rhettinger, scoder, eli.bendersky, docs@python, martin.panter, jlaurens
2015-07-31 07:17:17ned.deilysetmessageid: <1438327037.07.0.810373316103.issue24079@psf.upfronthosting.co.za>
2015-07-31 07:17:17ned.deilylinkissue24079 messages
2015-07-31 07:17:16ned.deilycreate