Skip to content

[3.14] gh-156839: Fix inaccuracies in the xml.dom.pulldom documentation (GH-156840) - #156846

Merged
serhiy-storchaka merged 1 commit into
python:3.14from
miss-islington:backport-c265821-3.14
Sep 2, 2026
Merged

[3.14] gh-156839: Fix inaccuracies in the xml.dom.pulldom documentation (GH-156840)#156846
serhiy-storchaka merged 1 commit into
python:3.14from
miss-islington:backport-c265821-3.14

Conversation

@miss-islington

@miss-islington miss-islington commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Corrected:

  • the node types for the PROCESSING_INSTRUCTION and COMMENT events;
  • the return value of getEvent() at the end of the document;
  • the type of the argument of parseString();
  • references to the xml.dom interfaces, written as xml.dom.minidom.

Documented:

  • the event constants, which were referenced but never described;
  • PullDOM, SAX2DOM and the documentFactory argument;
  • the arguments of DOMEventStream, its reset() and clear() methods.

Added docstrings to the module, the classes and their public methods, and
removed the commented out paragraph about pulldom in the xml.dom
documentation, which was never rendered and refers to a site which no longer
exists.
(cherry picked from commit c265821)

Co-authored-by: Serhiy Storchaka storchaka@gmail.com

pythonGH-156840)

Corrected:

* the node types for the PROCESSING_INSTRUCTION and COMMENT events;
* the return value of getEvent() at the end of the document;
* the type of the argument of parseString();
* references to the xml.dom interfaces, written as xml.dom.minidom.

Documented:

* the event constants, which were referenced but never described;
* PullDOM, SAX2DOM and the documentFactory argument;
* the arguments of DOMEventStream, its reset() and clear() methods.

Added docstrings to the module, the classes and their public methods, and
removed the commented out paragraph about pulldom in the xml.dom
documentation, which was never rendered and refers to a site which no longer
exists.
(cherry picked from commit c265821)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
@serhiy-storchaka
serhiy-storchaka merged commit b11a11b into python:3.14 Sep 2, 2026
53 of 56 checks passed
@miss-islington
miss-islington deleted the backport-c265821-3.14 branch September 2, 2026 17:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants