summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEli Bendersky <eliben@gmail.com>2012-03-02 05:37:13 (GMT)
committerEli Bendersky <eliben@gmail.com>2012-03-02 05:37:13 (GMT)
commit20293441da3ed1ee8e90de9747594090e27dca0e (patch)
treeb97da2ee598caf67c25e1db83af5bbe69b649a93
parentbbe2f60b3c19ecaa02ca07be14474eaacfcb59a0 (diff)
downloadcpython-20293441da3ed1ee8e90de9747594090e27dca0e.zip
cpython-20293441da3ed1ee8e90de9747594090e27dca0e.tar.gz
cpython-20293441da3ed1ee8e90de9747594090e27dca0e.tar.bz2
Issue #11379: add a note in xml.dom.minidom suggesting to use etree in some cases
-rw-r--r--Doc/library/xml.dom.minidom.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/Doc/library/xml.dom.minidom.rst b/Doc/library/xml.dom.minidom.rst
index ab5476d..ae286b0 100644
--- a/Doc/library/xml.dom.minidom.rst
+++ b/Doc/library/xml.dom.minidom.rst
@@ -15,6 +15,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::