diff --git a/Lib/xml/dom/minidom.py b/Lib/xml/dom/minidom.py index a32d4242a49..54e89cf06db 100644 --- a/Lib/xml/dom/minidom.py +++ b/Lib/xml/dom/minidom.py @@ -32,7 +32,9 @@ class Node(xml.dom.Node): - """Define properties accessible on a DOM node.""" + """Base class representing a node in the DOM tree. + Provides core properties and methods that all DOM nodes must implement. + """ namespaceURI = None # this is non-null only for elements and attributes parentNode = None ownerDocument = None @@ -84,11 +86,11 @@ def _get_lastChild(self): def insertBefore(self, newChild, refChild): """Insert a new DOM Node before an existing Node. - https://dom.spec.whatwg.org/#dom-node-insertbefore - The insertBefore(node, child) method, when invoked, - must return the result of pre-inserting node into - this before child. - See also https://dom.spec.whatwg.org/#concept-node-pre-insert + newChild + The new node to insert + refChild + The existing node that will be the next sibling of newChild. + If None, newChild is appended to the end. """ if newChild.nodeType == self.DOCUMENT_FRAGMENT_NODE: for c in tuple(newChild.childNodes):