https://github.com/python/cpython/commit/1031cf4e660c8462c716fbb24887a6e7885eb847 commit: 1031cf4e660c8462c716fbb24887a6e7885eb847 branch: 3.14 author: Miss Islington (bot) <[email protected]> committer: serhiy-storchaka <[email protected]> date: 2026-08-30T11:15:26Z summary:
[3.14] gh-57952: Clarify that xml.dom documents DOM interfaces (GH-156647) (GH-156652) The names documented in the "Objects in the DOM" section are interfaces from the DOM specification, not classes provided by the xml.dom module. (cherry picked from commit ae93e425ff408e91a6dc0cf93b0c6887cf0a8bde) Co-authored-by: Serhiy Storchaka <[email protected]> files: M Doc/library/xml.dom.rst diff --git a/Doc/library/xml.dom.rst b/Doc/library/xml.dom.rst index 6f41350b47850a..56a954b95138ce 100644 --- a/Doc/library/xml.dom.rst +++ b/Doc/library/xml.dom.rst @@ -156,6 +156,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]
