[Bug 5944] New: Unclear wording, section 8.2.3.1

http://www.w3.org/Bugs/Public/show_bug.cgi?id=5944

           Summary: Unclear wording, section 8.2.3.1
           Product: HTML WG
           Version: unspecified
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Spec bugs
        AssignedTo: dave.null@w3.org
        ReportedBy: bugmail@entai.co.uk
         QAContact: public-html-bugzilla@w3.org
                CC: ian@hixie.ch, mike@w3.org, public-html@w3.org


Section 8.2.3.1, "The insertion mode", is somewhat unclear:

> Seven of these modes, namely "in head", "in body", "in table", "in table body",
> "in row", "in cell", and "in select", are special, in that the other modes 
> defer to them at various times. When the algorithm below says that the user 
> agent is to do something "using the rules for the m insertion mode", where m is 
> one of these modes, the user agent must use the rules described under that 
> insertion mode's section, but must leave the insertion mode unchanged (unless 
> the rules in that section themselves switch the insertion mode). 

The last sentence caused a little confusion whilst implementing.  I suggest
that it be changed to something closer to:  (changed text in asterisks)

"When the algorithm below says that the user agent is to do something "using
the rules for the m insertion mode", where m is one of these modes, the user
agent must use the rules described under that insertion mode's section, but
must leave the insertion mode unchanged *unless the m insertion mode's rules
change it.*"


-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.

Received on Saturday, 9 August 2008 16:17:27 UTC