https://github.com/python/cpython/commit/ae93e425ff408e91a6dc0cf93b0c6887cf0a8bde commit: ae93e425ff408e91a6dc0cf93b0c6887cf0a8bde branch: main author: Serhiy Storchaka <[email protected]> committer: serhiy-storchaka <[email protected]> date: 2026-08-30T11:07:33Z summary:
gh-57952: Clarify that xml.dom documents DOM interfaces (GH-156647) The names documented in the "Objects in the DOM" section are interfaces from the DOM specification, not classes provided by the xml.dom module. files: M Doc/library/xml.dom.rst diff --git a/Doc/library/xml.dom.rst b/Doc/library/xml.dom.rst index 250b9be99a8bd3..6f5904fdf35e80 100644 --- a/Doc/library/xml.dom.rst +++ b/Doc/library/xml.dom.rst @@ -153,6 +153,11 @@ Objects in the DOM The definitive documentation for the DOM is the DOM specification from the W3C. +The names documented in this section are DOM interfaces. +With the exception of :class:`Node` and the exception classes, +they are not provided by the :mod:`!xml.dom` module itself, +but by concrete DOM implementations, such as :mod:`xml.dom.minidom`. + Note that DOM attributes may also be manipulated as nodes instead of as simple strings. It is fairly rare that you must do this, however, so this usage is not yet documented. _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3//lists/python-checkins.python.org Member address: [email protected]
