<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>15252</bug_id>
          
          <creation_ts>2011-12-17 01:28:12 +0000</creation_ts>
          <short_desc>Documentation error - TreeWalker.nextNode()</short_desc>
          <delta_ts>2011-12-17 11:01:36 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WebAppsWG</product>
          <component>DOM</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows NT</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>WORKSFORME</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>minor</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Brandon Slade">brandonyoyoslade</reporter>
          <assigned_to name="Anne">annevk</assigned_to>
          <cc>mike</cc>
    
    <cc>www-dom</cc>
          
          <qa_contact>public-webapps-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>61730</commentid>
    <comment_count>0</comment_count>
    <who name="Brandon Slade">brandonyoyoslade</who>
    <bug_when>2011-12-17 01:28:12 +0000</bug_when>
    <thetext>The current instructions for implementing this method can be found at http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-treewalker-nextnode.

Step 3.2 states that implementors should:

&quot;If a node is following node and is not following root, set node to the first such node. Otherwise, run these substeps again.&quot;

Earlier in the steps, you were instructed to set node to currentNode. Since currentNode is always a descendant of root, this means that the first &quot;if&quot; statement is never true - the &quot;otherwise&quot; or &quot;else&quot; clause is executed immediately. After some thought, I believe that you meant the following instead:

&quot;If a node is following node and is A DESCENDANT OF root, set node to the first such node. Otherwise, run these substeps again.&quot;

If this is what you meant, then please change it. If not, then please clear up exactly what you meant.

Also, there is a step 3.3, so consider changing the second sentence of 3.2 to &quot;Otherwise, SKIP THE REMAINING SUBSTEPS AND THEN run them again.&quot; or &quot;Otherwise, SKIP STEP 3 AND THEN run these substeps again.&quot;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>61738</commentid>
    <comment_count>1</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2011-12-17 10:45:53 +0000</bug_when>
    <thetext>currentNode can be set to anything so it does not have to be a descendant.

I have made the clarification in the end.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>61741</commentid>
    <comment_count>2</comment_count>
    <who name="Anne">annevk</who>
    <bug_when>2011-12-17 11:01:36 +0000</bug_when>
    <thetext>https://bitbucket.org/ms2ger/dom-core/changeset/c5238c17e1f4</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>