[issue13743] xml.dom.minidom.Document class is not documented

Martin Panter report at bugs.python.org
Fri Jan 15 19:13:57 EST 2016


Martin Panter added the comment:

In xml.dom, the documentation suggests that there are classes called Document and others, and I was surprised to find that they don’t exist. Apparently they are more like pseudo-code names of abstract interfaces instead. However in xml.dom.minidom there is a real Python class called Document. The documentation should be clearer about this.

I don’t think we need to duplicate the descriptions already given in xml.dom. But it would be good to explicitly say what the public minidom classes are, and point out (or link) what APIs they support.

----------
components: +XML
nosy: +martin.panter

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue13743>
_______________________________________


More information about the Python-bugs-list mailing list