From 20293441da3ed1ee8e90de9747594090e27dca0e Mon Sep 17 00:00:00 2001 From: Eli Bendersky Date: Fri, 2 Mar 2012 07:37:13 +0200 Subject: [PATCH] Issue #11379: add a note in xml.dom.minidom suggesting to use etree in some cases --- Doc/library/xml.dom.minidom.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Doc/library/xml.dom.minidom.rst b/Doc/library/xml.dom.minidom.rst index ab5476d91f1..ae286b0ad95 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::