]> granicus.if.org Git - python/commitdiff
#11379: rephrase minidom documentation to use the term "minimal" instead of "lightwei...
authorEzio Melotti <ezio.melotti@gmail.com>
Tue, 22 Jan 2013 20:47:57 +0000 (22:47 +0200)
committerEzio Melotti <ezio.melotti@gmail.com>
Tue, 22 Jan 2013 20:47:57 +0000 (22:47 +0200)
Doc/library/xml.dom.minidom.rst
Lib/xml/dom/minidom.py

index ae286b0ad95cf79ea349fd669ffce844f530ffdb..b512d7ee72f9635fc72e6c953bc459b12d13b626 100644 (file)
@@ -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>
 
 --------------
 
-: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::
index f23ad053333b53005612cbf88fbefc1b5a0e2954..1870ebd8a2dbf6f2b3b30be738accad3267684a5 100644 (file)
@@ -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")