From 2b65408dec44e877c63b73002fb03cef3f999f2c Mon Sep 17 00:00:00 2001 From: Eli Bendersky Date: Fri, 2 Mar 2012 07:45:55 +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 69e9e56a1f..ca19d98abb 100644 --- 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:: -- 2.50.0