P4
A DESCRIPTION OF THE PROBLEM :
The javadoc comment for the class org.w3c.dom.DOMImplementationSource contains an incomplete sentence:
"[...] as specified in ."
There should probably be a link there.
Judging from
http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#DOMImplementationSource
that link should point at
http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#DOMFeatures
and be labeled "DOM Features".
I'm not sure who maintains the Java DOM bindings, whether the JDK developers or the W3C DOM working group. If the latter, let me know and I'd try to push this issue to their bug tracking mechanism. Given the choice, I guess I'd prefer having it maintained along with the rest of the JDK, though, so I'll write here first.
EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
/**
* This interface permits a DOM implementer to supply one or more
* implementations, based upon requested features and versions, as specified
* in <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#DOMFeatures'>DOM
* Features</a>. Each implemented <code>DOMImplementationSource</code> object is
* listed in the binding-specific list of available sources so that its
* <code>DOMImplementation</code> objects are made available.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
*/
ACTUAL -
/**
* This interface permits a DOM implementer to supply one or more
* implementations, based upon requested features and versions, as specified
* in . Each implemented <code>DOMImplementationSource</code> object is
* listed in the binding-specific list of available sources so that its
* <code>DOMImplementation</code> objects are made available.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
*/
URL OF FAULTY DOCUMENTATION :
http://java.sun.com/javase/6/docs/api/org/w3c/dom/DOMImplementationSource.html
The javadoc comment for the class org.w3c.dom.DOMImplementationSource contains an incomplete sentence:
"[...] as specified in ."
There should probably be a link there.
Judging from
http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#DOMImplementationSource
that link should point at
http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#DOMFeatures
and be labeled "DOM Features".
I'm not sure who maintains the Java DOM bindings, whether the JDK developers or the W3C DOM working group. If the latter, let me know and I'd try to push this issue to their bug tracking mechanism. Given the choice, I guess I'd prefer having it maintained along with the rest of the JDK, though, so I'll write here first.
EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
/**
* This interface permits a DOM implementer to supply one or more
* implementations, based upon requested features and versions, as specified
* in <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#DOMFeatures'>DOM
* Features</a>. Each implemented <code>DOMImplementationSource</code> object is
* listed in the binding-specific list of available sources so that its
* <code>DOMImplementation</code> objects are made available.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
*/
ACTUAL -
/**
* This interface permits a DOM implementer to supply one or more
* implementations, based upon requested features and versions, as specified
* in . Each implemented <code>DOMImplementationSource</code> object is
* listed in the binding-specific list of available sources so that its
* <code>DOMImplementation</code> objects are made available.
* <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>.
* @since DOM Level 3
*/
URL OF FAULTY DOCUMENTATION :
http://java.sun.com/javase/6/docs/api/org/w3c/dom/DOMImplementationSource.html