[docs] [issue11379] Remove "lightweight" from minidom description
report at bugs.python.org
Wed Mar 2 20:25:08 CET 2011
New submission from Stefan Behnel <scoder at users.sourceforge.net>:
presents MiniDOM as a "Lightweight DOM implementation". The word "lightweight" is easily misunderstood as meaning "efficient" or "memory friendly". MiniDOM is well known to be neither of the two.
The first paragraph then continues:
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.
Again, "smaller" can be misread as "low memory footprint", whereas it is actually supposed to refer to an incomplete DOM API implementation. And "simpler" is also clearly exaggerated when compared to the alternative ElementTree package.
I would like to see this changed and combined with a clear and visible comment that MiniDOM has very high resource profile, e.g.
19.7. xml.dom.minidom — Pure Python DOM implementation
xml.dom.minidom is a pure Python implementation of the Document Object Model interface, as known from other programming languages. It is intended to provide a smaller API than the full DOM.
Note, however, that MiniDOM has a very large memory footprint compared to other Python XML libraries. If you need a fast and memory friendly XML tree implementation with a vastly simpler API, use the xml.etree package instead.
assignee: docs at python
nosy: docs at python, scoder
title: Remove "lightweight" from minidom description
versions: Python 2.7, Python 3.2, Python 3.3
Python tracker <report at bugs.python.org>
More information about the docs