From: Eli Bendersky <eliben@gmail.com>
Date: Fri, 2 Mar 2012 05:37:13 +0000 (+0200)
Subject: Issue #11379: add a note in xml.dom.minidom suggesting to use etree in some cases
X-Git-Tag: v3.3.0a1~18^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=20293441da3ed1ee8e90de9747594090e27dca0e;p=thirdparty%2FPython%2Fcpython.git

Issue #11379: add a note in xml.dom.minidom suggesting to use etree in some cases
---

diff --git a/Doc/library/xml.dom.minidom.rst b/Doc/library/xml.dom.minidom.rst
index ab5476d91f13..ae286b0ad95c 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::