From da4b5b82a3b2ec27f9112cc0338a3b20f502b892 Mon Sep 17 00:00:00 2001 From: Ezio Melotti Date: Tue, 22 Jan 2013 22:47:57 +0200 Subject: =?UTF-8?q?#11379:=20rephrase=20minidom=20documentation=20to=20use?= =?UTF-8?q?=20the=20term=20"minimal"=20instead=20of=20"lightweight".=20=20?= =?UTF-8?q?Patch=20by=20=C3=89ric=20Araujo.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Doc/library/xml.dom.minidom.rst | 22 ++++++++-------------- 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 ae286b0..b512d7e 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 .. sectionauthor:: Paul Prescod .. sectionauthor:: Martin v. Löwis @@ -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 f23ad05..1870ebd 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") -- cgit v0.12