#11379: rephrase minidom documentation to use the term "minimal" instead of "lightweight". Patch by Éric Araujo.

This commit is contained in:
Ezio Melotti 2013-01-22 22:47:57 +02:00
parent a0c9a4ed75
commit f5da3ec5ee
2 changed files with 11 additions and 16 deletions

View 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>
@ -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::

View 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")