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 terry.reedy
Recipients ash, docs@python, eric.araujo, ezio.melotti, flox, petri.lehtinen, terry.reedy
Date 2011-10-29.00:24:17
SpamBayes Score 2.446404e-07
Marked as misclassified No
Message-id <1319847859.26.0.0404629548836.issue13275@psf.upfronthosting.co.za>
In-reply-to
Content
In the tutorial, "The xml.dom and xml.sax packages" should be expanded to "The xml.dom, xml.sax, and xml.etree packages". I suspect that the current line predates the addition of .etree.

We try to mostly not give opinion-based recommendations; the docs are for facts. Some people recommend using lxml instead of any of the above ;-).

"The documentation for the xml.dom and xml.sax packages are the definition of the Python bindings for the DOM and SAX interfaces."

could be followed by a factual sentence like "xml.etree provides an  third alternative."

Looking more: the intro to 19.6. xml.dom — The Document Object Model API nicely explains the difference between SAX and DOM processing as sequential versus random access. The intro to 19.13. xml.etree.ElementTree — The ElementTree XML API says nothing about how it compares to the others. Perhaps the sentence should be "xml.etree provides a tree-based interface different from xml.dom." (assuming this is a fact). Make your suggestion.
History
Date User Action Args
2011-10-29 00:24:19terry.reedysetrecipients: + terry.reedy, ezio.melotti, ash, eric.araujo, flox, docs@python, petri.lehtinen
2011-10-29 00:24:19terry.reedysetmessageid: <1319847859.26.0.0404629548836.issue13275@psf.upfronthosting.co.za>
2011-10-29 00:24:18terry.reedylinkissue13275 messages
2011-10-29 00:24:17terry.reedycreate