- From: Sander Bos <sander@x-hive.com>
- Date: Fri, 18 Oct 2002 10:12:16 +0200
- To: "WWW DOM" <www-dom@w3.org>
> I am still seeing people confused by the fact that > createElement("foo") > and createElementNS(null,"foo") are not interchangable. Ditto for > attributes. This must mean that some people do not read the DOM specification in its entirety when they start using the DOM. > I can point them to DOM 2.0 Core 1.1.8, but it would be good > to have an > official practical-advice summary. "Yes, they're different > and not really > ineroperable. Unless you are writing a pure DOM 1.0 > application, don't use > the non-namespace-aware version of these calls." > > Might be worth considering for future releases.) I second the motion. If they can't simply be deprecated, I would still use deprecation style (so forcefull) language, example: public Element createElement(java.lang.String tagName) throws DOMException <p>You should not use this method, use createElementNS(null, tagName) instead. See <a href="*">the DOM specification</a> for details.</p> Creates an element of the type .... the same for createAttribute, setAttribute (there are a bunch of others, but most are getters so there it is not that important?). Kind regards, --Sander. *) http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#Namesp aces-Considerations
Received on Friday, 18 October 2002 04:12:54 UTC