diff options
author | Ezio Melotti <ezio.melotti@gmail.com> | 2013-01-22 22:49:46 +0200 |
---|---|---|
committer | Ezio Melotti <ezio.melotti@gmail.com> | 2013-01-22 22:49:46 +0200 |
commit | 5dd6281a1e3a7a634bc0b7477e2c6375cbfe6360 (patch) | |
tree | e967eed7c781b50b0cf2b9889e5852d98e00cc38 | |
parent | c279aba22cf280687749bc25adbc142569d9091b (diff) | |
parent | f4fe1fdaae0463f9d1f8cf8d08f8227dc1d7537b (diff) | |
download | cpython-5dd6281a1e3a7a634bc0b7477e2c6375cbfe6360.tar.gz |
#11379: merge with 3.2.
-rw-r--r-- | Doc/library/xml.dom.minidom.rst | 22 | ||||
-rw-r--r-- | Lib/xml/dom/minidom.py | 5 |
2 files changed, 11 insertions, 16 deletions
diff --git a/Doc/library/xml.dom.minidom.rst b/Doc/library/xml.dom.minidom.rst index a5c6fb292b..a75325ffc8 100644 --- a/Doc/library/xml.dom.minidom.rst +++ b/Doc/library/xml.dom.minidom.rst @@ -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 <paul@prescod.net> .. sectionauthor:: Paul Prescod <paul@prescod.net> .. sectionauthor:: Martin v. Löwis <martin@v.loewis.de> @@ -11,17 +11,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 --git a/Lib/xml/dom/minidom.py b/Lib/xml/dom/minidom.py index 28e5030b86..55c4ce11c2 100644 --- a/Lib/xml/dom/minidom.py +++ b/Lib/xml/dom/minidom.py @@ -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") |