[issue13743] xml.dom.minidom.Document class is not documented
New submission from Sandro Tosi
Mark Lawrence added the comment:
This https://docs.python.org/3/library/xml.dom.minidom.html#module-xml.dom.minido... currently states under section 20.7.1 "The definition of the DOM API for Python is given as part of the xml.dom module documentation. This section lists the differences between the API and xml.dom.minidom.". The Document object is described here https://docs.python.org/3/library/xml.dom.html#document-objects
----------
nosy: +BreamoreBoy
_______________________________________
Python tracker
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
Changes by Mark Lawrence
Change by Henry Harutyunyan
Alex Itkes
Change by Alex Itkes
Change by Alex Itkes
Stefan Behnel
Stefan Behnel
participants (6)
-
Alex Itkes
-
Henry Harutyunyan
-
Mark Lawrence
-
Martin Panter
-
Sandro Tosi
-
Stefan Behnel