[ python-Bugs-1027771 ] In DOM Node Objects, add more explanations for insertBefore

[SourceForge.net]

Bugs item #1027771, was opened at 2004-09-14 10:53
Message generated for change (Settings changed) made by madarche
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1027771&group_id=5470

Category: Documentation
Group: Python 2.3
Status: Open
Resolution: None
>Priority: 2
Submitted By: M.-A. DARCHE (madarche)
Assigned to: Nobody/Anonymous (nobody)
Summary: In DOM Node Objects, add more explanations for insertBefore

Initial Comment:
At
http://www.python.org/doc/2.3.4/lib/dom-node-objects.html#l2h-4071
current documentation is:

insertBefore(newChild, refChild)
    Insert a new child node before an existing child.
It must be the case that refChild is a child of this
node; if not, ValueError is raised. newChild is returned.

While it could be more complete:

insertBefore(newChild, refChild)
    Insert a new child node before an existing child.
It must be the case that refChild is a child of this
node; if not, ValueError is raised. newChild is
returned. If refChild is None, it inserts newChild at
the end of the list of children.

Note that node.insertAfter(newKid, refChild), if it
existed, would be precisely equivalent to
node.insertBefore(newKid,refChild.getNextSibling()).


----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1027771&group_id=5470