<?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>21754</bug_id>
          
          <creation_ts>2013-04-19 18:42:55 +0000</creation_ts>
          <short_desc>[HTML] editorial: un-referenced step labels</short_desc>
          <delta_ts>2013-07-15 22:56:21 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WHATWG</product>
          <component>HTML</component>
          <version>unspecified</version>
          <rep_platform>All</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>minor</bug_severity>
          <target_milestone>Unsorted</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Michael Dyck">jmdyck</reporter>
          <assigned_to name="Ian &apos;Hixie&apos; Hickson">ian</assigned_to>
          <cc>gphemsley</cc>
    
    <cc>ian</cc>
    
    <cc>mike</cc>
          
          <qa_contact>contributor</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>86396</commentid>
    <comment_count>0</comment_count>
    <who name="Michael Dyck">jmdyck</who>
    <bug_when>2013-04-19 18:42:55 +0000</bug_when>
    <thetext>Certain step-labels appear to be superfluous, as they are never referenced:

    4.8.10.5 &quot;Loading the media resource&quot;
    the &apos;resource selection algorithm&apos;,
    step 9:
        Process candidate:
    (Note that step 9 has two steps labeled &quot;Process candidate&quot;.
    It&apos;s the first one that isn&apos;t referenced.)

    4.8.11.2.4 &quot;Line styles&quot;,
    the &apos;trace a path&apos; algorithm,
    step 19:
        Dash Off:

    9.2.4 &quot;Processing model&quot;
    step 10:
        Event loop:
    (At least, I&apos;m pretty sure it isn&apos;t referenced.)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>86403</commentid>
    <comment_count>1</comment_count>
    <who name="Ian &apos;Hixie&apos; Hickson">ian</who>
    <bug_when>2013-04-19 23:49:35 +0000</bug_when>
    <thetext>The first one is just confusing, so I removed it.

The other two (and the first one as well, in theory, though in practice it confuses matters as noted above) are intentional. The first (&quot;dash off&quot;) is there for symmetry with &quot;dash on&quot;. The other one is there because having an event loop is so key to the processing model of HTML and so on that having it clearly labeled as the relevant step is helpful for discussions of that part of the spec.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>86411</commentid>
    <comment_count>2</comment_count>
    <who name="Michael Dyck">jmdyck</who>
    <bug_when>2013-04-20 07:36:03 +0000</bug_when>
    <thetext>(In reply to comment #1)
&gt; The first one is just confusing, so I removed it.

Of the two steps labelled &quot;Process candidate&quot;,
you removed the label from the *second*, which surprises me.

Formerly, the substep that says:
    Otherwise, jump back to the /process candidate/ step.
would presumably have been interpreted as referring to the 15th-earlier
substep in the same list of substeps.

But now, that interpretation isn&apos;t available, and the jump can only refer to
the first substep in a completely separate list of substeps.

I had been thinking that a &apos;jump&apos; could only refer to one of its sibling-steps,
or to a sibling of one of its ancestor-steps. (That was the only way I could
make sense of the jumps and labels within this algorithm.) If, as it seems,
that&apos;s not the case, then when the (remaining) &quot;Process candidate&quot; step says:
    jump down to the /failed/ step below
it&apos;s somewhat ambiguous, because the algorithm has two steps labeled &quot;Failed&quot;,
and they&apos;re both below that step. 


&gt; The other one is there because having an event loop is so key to the
&gt; processing model of HTML and so on that having it clearly labeled as
&gt; the relevant step is helpful for discussions of that part of the spec.

But when you label a step to be helpful for discussion (rather than to be
the target of a jump), don&apos;t you normally use &lt;strong&gt; (rather than &lt;i&gt;)?
(E.g., &quot;Suspending workers&quot; in the same algorithm.)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>86499</commentid>
    <comment_count>3</comment_count>
    <who name="Ian &apos;Hixie&apos; Hickson">ian</who>
    <bug_when>2013-04-22 22:25:10 +0000</bug_when>
    <thetext>Woops, I meant to remove the first one. Thanks for checking that!

I should generally never have duplicate label names, even if they&apos;re in different subalgorithms, if they&apos;re all wrapped in the same overall list of steps. I&apos;ll look into that &quot;failed&quot; one.

Using &lt;strong&gt; instead of &lt;i&gt; is mostly random luck, but if I&apos;ve been consistent about that I&apos;ll look into being even more consistent!</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>88669</commentid>
    <comment_count>4</comment_count>
    <who name="">contributor</who>
    <bug_when>2013-06-04 21:18:11 +0000</bug_when>
    <thetext>Checked in as WHATWG revision r7902.
Check-in comment: Removed the wrong one in r7843.
http://html5.org/tools/web-apps-tracker?from=7901&amp;to=7902</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>88671</commentid>
    <comment_count>5</comment_count>
    <who name="">contributor</who>
    <bug_when>2013-06-04 21:22:06 +0000</bug_when>
    <thetext>Checked in as WHATWG revision r7903.
Check-in comment: More consistency in markup.
http://html5.org/tools/web-apps-tracker?from=7902&amp;to=7903</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>88672</commentid>
    <comment_count>6</comment_count>
    <who name="">contributor</who>
    <bug_when>2013-06-04 21:24:15 +0000</bug_when>
    <thetext>Checked in as WHATWG revision r7904.
Check-in comment: Avoid using the same label for two different steps in the same overall algorithm
http://html5.org/tools/web-apps-tracker?from=7903&amp;to=7904</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>89136</commentid>
    <comment_count>7</comment_count>
    <who name="Ian &apos;Hixie&apos; Hickson">ian</who>
    <bug_when>2013-06-11 22:58:46 +0000</bug_when>
    <thetext>*** Bug 22167 has been marked as a duplicate of this bug. ***</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>