<?xml version="1.0" encoding="iso-8859-1"?>
<?xml-stylesheet
  href="http://dev.w3.org/cvsweb/~checkout~/2002/issues/xsl/main.xsl?content-type=text/xsl"
  type="text/xsl"?>

<!--
 style sheets are available at
  http://dev.w3.org/cvsweb/2002/issues/xsl
-->

<!-- $Id: issues.xml,v 1.5 2005/05/10 14:07:11 plehegar Exp $ -->

<issues xmlns:xlink="http://www.w3.org/1999/xlink"
  xmlns:xi="http://www.w3.org/2001/XInclude"
  xmlns="http://www.w3.org/2003/10/issues"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="
  http://www.w3.org/2003/10/issues
  http://dev.w3.org/cvsweb/~checkout~/2002/issues/schema/issues.xsd">
  <header>
    <title>DOM Level 3 Core Issues List</title>
    <version>$Date: 2005/05/10 14:07:11 $</version>
    <w3c-designation></w3c-designation>
    <w3c-doctype>Issues List</w3c-doctype>
    <pubdate>
      <day>---08</day>
      <month>July</month>
      <year>2004</year>
    </pubdate>
    <publoc>
      <loc xlink:type='simple' xlink:href="http://www.w3.org/2004/07/08-dom-issues">http://www.w3.org/2004/07/08-dom-issues</loc>
    </publoc>
    <latestloc>
      <loc xlink:type='simple' xlink:href="http://www.w3.org/2004/07/08-dom-issues">http://www.w3.org/2004/07/08-dom-issues</loc>
    </latestloc>
    <authlist>
      <author>
	<name>DOM Interest Group</name>
	<uri xlink:type='simple' xlink:href="http://www.w3.org/DOM/"/>
      </author>
    </authlist>
    <abstract>
      <p>This is the official issues list for the DOM specifications.</p>
    </abstract>
    <status>
      <p>
	This document contains a list of issues regarding the DOM
	specifications. All comments or issues regarding the
	specification or this document must be reported to <loc
	xlink:type='simple'
	xlink:href="mailto:www-dom@w3.org">www-dom@w3.org</loc> (<loc
	xlink:type='simple'
	xlink:href="http://lists.w3.org/Archives/Public/www-dom/">public
	archives</loc>).
      </p>
      <p>
	An <loc xlink:type='simple' xlink:href='issues.xml'>XML
	version</loc> of this issues' list is also available.
      </p>
    </status>
    <langusage>
      <language id="en">English</language>
    </langusage>
    <revisiondesc>
      <p>$Revision: 1.5 $</p>
    </revisiondesc>
  </header>
  <body>
    <issue type="editorial" id="ls-1">
      <title>appendix E or B?</title>
      <references>
        <loc xlink:type='simple'
          xlink:href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407/load-save.html#LS-LSSerializer">LSSerializer</loc>
      </references>
      <transitions>
        <raised xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004Apr/0004.html">
          <date>2004-04-14</date>
          <description>
            <p>
	      The document references appendix E of XML 1.1 when it
	      meant to reference appendix B.
	    </p>
          </description>
          <originator xlink:type='simple' xlink:href="mailto:K.Venugopal@Sun.COM">Venu</originator>
        </raised>
      </transitions>
    </issue>
    
    <issue type="proposal" id="core-1">
      <title>DOMImplementationRegistry description</title>
      <references>
        <loc xlink:type='simple'
        xlink:href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/java-binding.html#Level-3-Java-Binding-Extension">Java
        Binding Extension</loc>
      </references>
      <transitions>
        <raised xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004Apr/0005.html">
          <date>2004-04-14</date>
          <description>
            <p>
	      The description of <code>DOMImplementationRegistry</code>
	      in the DOM Level 3 Core Java binding, does not mention
	      that a service provider will be used if the system
	      property is not set.
	    </p>
	    <p>
	      It would have been nice if it mentioned something similar
	      to the description for the <code>newInstance()</code>
	      method ... <quote>The
	      <code>DOMImplementationRegistry</code> is initialized by
	      the application or the implementation, depending on the
	      context, by first checking the value of the Java system
	      property
	      <code>org.w3c.dom.DOMImplementationSourceList</code> and
	      then the service provider whose contents are at
	      <code>META_INF/services/org.w3c.dom.DOMImplementationSourceList</code>.
	      The value of this property is a white-space separated list
	      of names of available classes implementing the
	      <code>DOMImplementationSource</code> interface.</quote>
            </p>
          </description>
          <originator xlink:type='simple' xlink:href="mailto:nddelima@ca.ibm.com">Neil Delima</originator>
        </raised>
      </transitions>
    </issue>
    
    <issue type="error" id="ls-2">
      <title>well-formed parameter and errors</title>
      <references>
        <loc xlink:type='simple'
          xlink:href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407/load-save.html#parameter-well-formed">well-formed parameter in LSParser</loc>
        <loc xlink:type='simple'
          xlink:href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407/load-save.html#LS-LSSerializer">well-formed parameter in LSSerializer</loc>
      </references>
      <transitions>
        <raised xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004Apr/0007.html">
          <date>2004-04-30</date>
          <description>
            <p>
	      The "well-formed" parameter in DOM Level 3 Load and Save
	      references the "well-formed" parameter in Core.  This
	      means that when a not well-formed error of type
	      "wf-invalid-character-in-node-name" and
	      "wf-invalid-character" occurs while loading or saving a
	      document, the value of DOMError.severity should be
	      SEVERITY_ERROR since Core specifies this.  Should the
	      description of the "well-formed" parameter in the LS
	      specification be modified to report an error of severity
	      SEVERITY_FATAL_ERROR instead?
	    </p>
	  </description>
          <originator xlink:type='simple' xlink:href="mailto:nddelima@ca.ibm.com">Neil Delima</originator>
	</raised>
      </transitions>
    </issue>
    <issue type="clarification" id="ls-3">
      <title>well-formed, and namespaces parameters</title>
      <references>
        <loc xlink:type='simple'
          xlink:href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407/load-save.html#parameter-well-formed">well-formed parameter in LSParser</loc>
        <loc xlink:type='simple'
          xlink:href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407/load-save.html#LS-LSSerializer">well-formed parameter in LSSerializer</loc>
      </references>
      <transitions>
        <raised xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004Apr/0007.html">
          <date>2004-04-30</date>
          <description>
	    <p>
	      It might be worth mentioning in the spec the potential
	      well-formedness errors that may arise during serialization
	      when "namespace-declarations" is set to false,
	      "namespaces" to true and "well-formed" to true.
	    </p>
          </description>
          <originator xlink:type='simple' xlink:href="mailto:nddelima@ca.ibm.com">Neil Delima</originator>
        </raised>
      </transitions>
    </issue>

    <issue type="proposal" id="core-2">
      <title>User data handling for adoption, deletion and renaming?</title>
      <references>
        <loc xlink:type='simple'
          xlink:href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-handleUserDataEvent">UserDataEvent.handle</loc>
      </references>
      <transitions>
        <raised xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004Apr/0007.html">
          <date>2004-04-30</date>
          <description>
	    <p>
	      Though the specification does not mention it, when a node
	      is adopted, the UserData associated is carried over,
	      right?  A minor editorial point, noticed that the
	      description for DOMUserDataHandler - handle(...) [1]
	      mentions "This method is called whenever the node for
	      which this handler is registered is imported or cloned".
	      Is there any need to mention other operations namely
	      adopted, deleted and renamed for which the method is
	      invoked.
            </p>
          </description>
          <originator xlink:type='simple' xlink:href="mailto:nddelima@ca.ibm.com">Neil Delima</originator>
        </raised>
      </transitions>
    </issue>
    
    <issue type="clarification" id="ls-4">
      <title>parseURI and null return value</title>
      <references>
        <loc xlink:type='simple'
        xlink:href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407/load-save.html#LS-LSParser-parseURI">LSParser.parseURI</loc>
      </references>
      <transitions>
        <raised xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004May/0000.html">
          <date>2004-05-20</date>
          <description>
            <p>
	      The <code>parseURI</code> method from the DOM Level 3 LS
	      states: <quote>If the LSParser is a synchronous LSParser,
	      the newly created and populated Document is returned, or
	      null if an error occurred.</quote> Seems a bit odd, should
	      null be returned when validation errors occur?  The L3
	      Candidate Recommendation did not contain the condition "or
	      null if an error occurred."  What was the rationale behind
	      this change to the PR?
	    </p>
          </description>
          <originator xlink:type='simple' xlink:href="mailto:nddelima@ca.ibm.com">Neil Delima</originator>
        </raised>
      </transitions>
      <discussions>
        <discussion xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004May/0001.html">
          <date>2004-05-27</date>
        </discussion>
      </discussions>
    </issue>
    
    <issue type="clarification" id="core-3">
      <title>adoptNode and failure</title>
      <references>
        <loc xlink:type='simple'
        xlink:href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#Document3-adoptNode">Document.adoptNode</loc>
      </references>
      <transitions>
        <raised xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004May/0000.html">
          <date>2004-05-20</date>
          <description>
            <p>
	      According to the DOM Level 3 Core Recommendation for
	      <code>Document.adoptNode</code>, <quote>Return Value: The
	      adopted node, or null if this operation fails, such as
	      when the source node comes from a different
	      implementation.</quote> and <quote>Exceptions:
	      <code>NO_MODIFICATION_ALLOWED_ERR</code>: Raised when the
	      source node is read-only.</quote> So should an attempt to
	      adopt a read-only node across DOM implementations return
	      <code>null</code> or throw a <code>DOMException</code> or
	      is this implementation dependant?
	    </p>
          </description>
          <originator xlink:type='simple' xlink:href="mailto:nddelima@ca.ibm.com">Neil Delima</originator>
        </raised>
      </transitions>
      <discussions>
        <discussion xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004May/0001.html">
          <date>2004-05-27</date>
        </discussion>
      </discussions>
    </issue>
    
    <issue type="clarification" id="html-1">
      <title>focus and DOM Level 2 HTML</title>
      <references>
        <loc xlink:type='simple'
        xlink:href="http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109/">DOM Level 2 HTML</loc>
      </references>
      <transitions>
        <raised xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004Jun/0000.html">
          <date>2004-06-09</date>
          <description>
            <p>
	      As part of the DHTML accessibility Roadmap effort we
	      determined that one of the most critical issues with
	      JavaScript is that user agents do not allow the author to
	      give focus change to any element within the DOM.
	      JavaScript authors treat all elements as active and will
	      quite often place onclick and onmouseover event handlers
	      on virtually any element, including DIVS and
	      SPANS. Assistive technologies are designed to follow the
	      users focus. It is the responsibility of the author to
	      ensure that focus is given to an element so that the user
	      and assistive technology can follow focus. In US Public
	      law 508 this is provided indirectly by requiring that
	      keyboard equivalents for all mouse actions.
	    </p>
	    <p>
	      DOM level 2 HTML indicates that the focus method is only
	      provided for on anchors and form elements. In discussing
	      the issue with Raman this document only reflects common
	      practice on the web rather than what actually may be
	      done. I feel this is the source of confusion. DOM level 2
	      for any element to be active within the DOM. If this is
	      true then all elements should have the ability to receive
	      focus.
	    </p>
	    <p>
	      Please clarify if the current implementation by user
	      agents is incorrect? May all document elements receive
	      focus?
	    </p>
	    <p>
	      If the response by the group is that the current
	      interpretation is incorrect and that all elements may
	      receive focus then the Mozilla team has agreed to correct
	      this problem by adding the focus() method to all
	      elements. If the response is that the interpretation is
	      correct then we need to have reform.
	    </p>
          </description>
          <originator xlink:type='simple' xlink:href="mailto:schwer@us.ibm.com">Richard Schwerdtfeger</originator>
        </raised>
      </transitions>
    </issue>
    
    <issue type="clarification" id="events-1">
      <title>DOMFocusIn|Out, DOMActivate</title>
      <references>
        <loc xlink:type='simple'
        xlink:href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Events-20001113/events.html#Events-UIEvent">UIEvent</loc>
      </references>
      <transitions>
        <raised xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004Jun/0000.html">
          <date>2004-06-09</date>
          <description>
            <p>
	      User agents should also allow the author to dispatch
	      DOMFocusIn, DOMFocusOut, and DOMActivate events to any
	      element within the DOM. Currently Mozilla does not allow
	      this. While it claims to support DOM2, DOMFocusIn,
	      DOMFocusOut, and DOMActivate are not generated from the
	      browser in response to an onclick or a mouse click. This
	      make the script authoring more complex. In order to
	      provide equal access to the keyboard, the author must map
	      a handler for the keyboard click and mouseclick rather
	      than simply responding to a DOMActivate.
	    </p>
	    <p>
	      Should the user agent:
	    </p>
	    <ulist>
	      <item>allow DOMFocusIn, DOMFocusOut, DOMActivate to go to all elements?</item>
	      <item>allow the author to dispatch these events to all events?</item>
	    </ulist>
          </description>
          <originator xlink:type='simple' xlink:href="mailto:schwer@us.ibm.com">Richard Schwerdtfeger</originator>
        </raised>
      </transitions>
    </issue>
    
    <issue type="error" id="core-4">
      <title>Memory leak in DOMImplementationRegistry</title>
      <references>
        <loc xlink:type='simple'
        xlink:href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/java-binding.html#Level-3-Java-Binding-Extension">Java Binding Extension</loc>
      </references>
      <transitions>
        <raised xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004Jun/0001.html">
          <date>2004-06-11</date>
          <description>
            <p>
	      There exists a possibility of a memory leak that can
	      originate from
	      <code>DOMImplementationRegistry.java</code>. If an
	      <code>IOException</code> is thrown when the
	      <code>getServiceValue()</code> method from
	      <code>DOMImplementationRegistry.java</code> attempts to
	      read a service provider to retrieve the resource
	      <code>META_INF/services/org.w3c.dom.DOMImplementationSourceList</code>,
	      the underlying <code>InputStream</code> is never closed
	      and this may result in a memory leak. The method
	      <code>getServiceValue</code> should read:
	    </p>
	    <eg>    private static String getServiceValue(final ClassLoader classLoader) {
	String serviceId = "META-INF/services/" + PROPERTY;
	InputStream is = null;
	BufferedReader rd = null;    
	String serviceValue = null;
	
	// try to find services in CLASSPATH
	try {
	    is = getResourceAsStream(classLoader, serviceId);
	    
	    if (is != null) {
		try {
		    rd =
			new BufferedReader(new InputStreamReader(is, "UTF-8"),
					   DEFAULT_LINE_LENGTH);
		} catch (java.io.UnsupportedEncodingException e) {
		    rd =
			new BufferedReader(new InputStreamReader(is),
					   DEFAULT_LINE_LENGTH);
		}		
		serviceValue = rd.readLine();
	    }
	} catch (Exception ex) {
	    return null;
	}
	finally {
	    if (rd != null) {
		try {
		    // try to close the reader.
		    rd.close();
		}
		// Ignore the exception.
		catch (Exception ex) {}
	    }    
	}
	
	if (serviceValue != null &amp;&amp; serviceValue.length() > 0) {
	    return serviceValue;
	} else { 
	    return null;
	}    
    }</eg>
          </description>
          <originator xlink:type='simple' xlink:href="mailto:nddelima@ca.ibm.com">Neil Delima</originator>
        </raised>
      </transitions>
    </issue>
    
    <issue type="error" id="core-5">
      <title>NO_DATA_ALLOWED_ERR is not used?!?</title>
      <references>
        <loc xlink:type='simple'
        xlink:href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#DOMException-NO_DATA_ALLOWED_ERR">NO_DATA_ALLOWED_ERR</loc>
      </references>
      <transitions>
        <raised xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Member/w3c-dom-ig/2004Jun/0001.html">
          <date>2004-06-11</date>
          <description>
            <p>
	      is the <code>DOMException</code>
	      <code>NO_DATA_ALLOWED_ERR</code> referenced anywhere in
	      the specs?
	    </p>
          </description>
          <originator xlink:type='simple' xlink:href="mailto:nddelima@ca.ibm.com">Neil Delima</originator>
        </raised>
      </transitions>
    </issue>
    
    <issue type="clarification" id="core-6">
      <title>compareDocumentPosition and DocumentPosition</title>
      <references>
        <loc xlink:type='simple'
        xlink:href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#Node3-compareDocumentPosition">Node.compareDocumentPosition</loc>
        <loc xlink:type='simple'
        xlink:href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#DocumentPosition">DocumentPosition</loc>
      </references>
      <transitions>
        <raised xlink:type='simple' xlink:href="http://lists.w3.org/Archives/Public/www-dom/2005AprJun/0022.html">
          <date>2005-04-28</date>
          <description>
            <p>
	      <code>compareDocumentPosition</code> does not say that
	      its returned value is defined by the DocumentPosition
	      constants.
	    </p>
          </description>
          <originator xlink:type='simple' xlink:href="mailto:keshlam-nospam@comcast.net">Joe Kesselman</originator>
        </raised>
      </transitions>
    </issue>
    
  </body>
</issues>
<!-- end of issues -->
