117339 - documentation on insertBefore is wrong

Status: VERIFIED FIXED

(Documentation Graveyard :: Web Developer, defect)

Description

[Jonas Sicking (:sicking) No longer reading bugmail consistently]

The documentation for insertBefore is compleatly wrong, see

http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-952280727

Comment 1

[Fabian Guisset]

It should read:
*****************************************
The insertBefore method allows you to insert a node before a reference element
as a child of the current node.

Syntax:
insertedElement = element.insertBefore(newElement, referenceElement);

Parameters:
insertedElement: The node being inserted
newElement: The node to insert
referenceElement: "newElement" will be inserted before "referenceElement"

Example:
parentDiv = document.getElementById("parentDiv");
sp2 = document.getElementById("childSpan");
sp1 = document.createElement("span");
parentDiv.insertBefore(sp1, sp2);


BTW, there's a problem at the http://mozilla.org/docs/dom/domref/ page.
The "DOM Window Reference" is not a top-level title. Must be a markup error.

Thanks Sicking btw :)

Comment 2

[Ian Oeschger (gone)]

Accepting. Fixed in next rev of domref. Thanks sicking and fabian

Comment 3

[Ian Oeschger (gone)]

marking FIXED.

Comment 4

[Daniel Wang]

v