W3C home > Mailing lists > Public > www-dom@w3.org > January to March 2002

DOM L2 javadoc bug

From: Rahul Srivastava <Rahul.Srivastava@sun.com>
Date: Mon, 18 Feb 2002 14:11:53 +0000 (Asia/Calcutta)
Message-Id: <200202180847.g1I8llt15120@blr-root.India.Sun.COM>
To: www-dom@w3.org

The javadoc comment for getNodeValue() in org.w3c.dom.Node interface is having 
some problem. It says:

     * The value of this node, depending on its type; see the table above. 
     * When it is defined to be <code>null</code>, setting it has no effect.
     * @exception DOMException
     *   NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
     * @exception DOMException
     *   DOMSTRING_SIZE_ERR: Raised when it would return more characters than 
     *   fit in a <code>DOMString</code> variable on the implementation 
     *   platform.
But, getNodeValue(), never throws DOMException-NO_MODIFICATION_ALLOWED_ERR. 
Also, there is no javadoc for setNodeValue().

Same is true for get/setPrefix().

Can anybody tell me, where to file a bug for this?.

NOTE: This bug is in the zip available at: http://www.w3.org/DOM/DOMTR which I 
believe is the latest version. Please correct me, if I am wrong.

Suggestion: In some places the javadoc says: "see the table above". But, there 
is no table in the javadoc for the interface. It would be better to put the 
table there (the one which shows nodeName, nodeValue and attributes for various 
types of Nodes under Interface Node, in DOM L2 core).


Sun Microsystems, Inc.
Received on Monday, 18 February 2002 03:47:58 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 20 October 2015 10:46:09 UTC