[Python-checkins] cpython (2.7): Issue #11379: add a note in xml.dom.minidom suggesting to use etree in some
eli.bendersky
python-checkins at python.org
Fri Mar 2 06:46:17 CET 2012
http://hg.python.org/cpython/rev/ccd16ad37544
changeset: 75368:ccd16ad37544
branch: 2.7
parent: 75360:d2cf730de195
user: Eli Bendersky <eliben at gmail.com>
date: Fri Mar 02 07:45:55 2012 +0200
summary:
Issue #11379: add a note in xml.dom.minidom suggesting to use etree in some cases
files:
Doc/library/xml.dom.minidom.rst | 8 ++++++++
1 files changed, 8 insertions(+), 0 deletions(-)
diff --git a/Doc/library/xml.dom.minidom.rst b/Doc/library/xml.dom.minidom.rst
--- a/Doc/library/xml.dom.minidom.rst
+++ b/Doc/library/xml.dom.minidom.rst
@@ -18,6 +18,14 @@
Model interface. It is intended to be simpler than the full DOM and also
significantly smaller.
+.. note::
+
+ The :mod:`xml.dom.minidom` module provides an implementation of the W3C-DOM,
+ with an API similar to that in other programming languages. Users who are
+ unfamiliar with the W3C-DOM interface or who would like to write less code
+ for processing XML files should consider using the
+ :mod:`xml.etree.ElementTree` module instead.
+
DOM applications typically start by parsing some XML into a DOM. With
:mod:`xml.dom.minidom`, this is done through the parse functions::
--
Repository URL: http://hg.python.org/cpython
More information about the Python-checkins
mailing list