[docs] [issue11379] Remove "lightweight" from minidom description
report at bugs.python.org
Thu Mar 3 10:29:01 CET 2011
Stefan Behnel <scoder at users.sourceforge.net> added the comment:
> If that is a real concern, I'd rather reduce the memory footprint of
> minidom than put actual performance figures into the documentation
> that will likely outdate over time.
Personally, I do not think it's worth putting much work into MiniDOM. I'd rather deprecate it to prevent new code from being written for it, but that's just my personal opinion, and this is the wrong place to discuss that. Given the current performance characteristics, I wouldn't be surprised if there was quite some room for improvements left in the xml.dom package.
If you dislike the "10x", feel free to use "several times". I doubt that MiniDOM will ever get so much closer to cET and lxml to prove that phrasing wrong.
> Notice that the documentation doesn't claim that it is a lightweight
> XML library, only that it's a ligthweight DOM implementation.
I imagine that you are as aware as I am that this nuance is easy to miss, especially for a new user. From my experience, it is very common for users, especially those with a Java-ish background, to confuse the terms "DOM" and "XML tree API/library". Hence my push to change the documentation.
> SAX is, of course, even lighter-weight.
Not so much more light weight than cET's iterparse(), but that's getting OT here.
Python tracker <report at bugs.python.org>
More information about the docs