changeset: 81664:c2ae1ed03853 branch: 2.7 parent: 81660:506abee7a764 user: Ezio Melotti date: Tue Jan 22 22:47:57 2013 +0200 files: Doc/library/xml.dom.minidom.rst Lib/xml/dom/minidom.py description: #11379: rephrase minidom documentation to use the term "minimal" instead of "lightweight". Patch by Éric Araujo. diff -r 506abee7a764 -r c2ae1ed03853 Doc/library/xml.dom.minidom.rst --- a/Doc/library/xml.dom.minidom.rst Tue Jan 22 15:57:12 2013 +0000 +++ b/Doc/library/xml.dom.minidom.rst Tue Jan 22 22:47:57 2013 +0200 @@ -1,8 +1,8 @@ -:mod:`xml.dom.minidom` --- Lightweight DOM implementation -========================================================= +:mod:`xml.dom.minidom` --- Minimal DOM implementation +===================================================== .. module:: xml.dom.minidom - :synopsis: Lightweight Document Object Model (DOM) implementation. + :synopsis: Minimal Document Object Model (DOM) implementation. .. moduleauthor:: Paul Prescod .. sectionauthor:: Paul Prescod .. sectionauthor:: Martin v. Löwis @@ -14,17 +14,11 @@ -------------- -:mod:`xml.dom.minidom` is a light-weight implementation of the Document Object -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. +:mod:`xml.dom.minidom` is a minimal implementation of the Document Object +Model interface, with an API similar to that in other languages. It is intended +to be simpler than the full DOM and also significantly smaller. Users who are +not already proficient with the DOM should consider using the +:mod:`xml.etree.ElementTree` module for their XML processing instead DOM applications typically start by parsing some XML into a DOM. With :mod:`xml.dom.minidom`, this is done through the parse functions:: diff -r 506abee7a764 -r c2ae1ed03853 Lib/xml/dom/minidom.py --- a/Lib/xml/dom/minidom.py Tue Jan 22 15:57:12 2013 +0000 +++ b/Lib/xml/dom/minidom.py Tue Jan 22 22:47:57 2013 +0200 @@ -1,5 +1,6 @@ -"""\ -minidom.py -- a lightweight DOM implementation. +"""Simple implementation of the Level 1 DOM. + +Namespaces and other minor Level 2 features are also supported. parse("foo.xml")