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

[SourceForge.net]

Bugs item #1027771, was opened at 2004-09-14 08:53
Message generated for change (Comment added) made by rodsenra
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()).


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

Comment By: Rodrigo Dias Arruda Senra (rodsenra)
Date: 2004-11-07 19:20

Message:
Logged In: YES 
user_id=9057

The patch 1062033 adds """
If refChild is None, it inserts newChild at
the end of the list of children.
""" to the xmldom.tex.

I left the last paragraph out of the patch, because I'm not
certain
it is clear enough or adequate.

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

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