[Bug 12322] New: [Polyglot] "Required Elements" - clarify use of <colgroup> and more.

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

           Summary: [Polyglot] "Required Elements" - clarify use of
                    <colgroup> and more.
           Product: HTML WG
           Version: unspecified
          Platform: PC
               URL: http://dev.w3.org/html5/html-xhtml-author-guide/html-x
                    html-authoring-guide.html#required-elements
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: HTML/XHTML Compatibility Authoring Guide (ed: Eliot
                    Graff)
        AssignedTo: eliotgra@microsoft.com
        ReportedBy: xn--mlform-iua@xn--mlform-iua.no
         QAContact: public-html-bugzilla@w3.org
                CC: mike@w3.org, public-html-wg-issue-tracking@w3.org,
                    public-html@w3.org, eliotgra@microsoft.com


The Polyglot Markup spec can easily be read to say that <colgroup> is
obligatory in any table:

]] Polyglot markup explicitly uses a colgroup element surrounding groups of col
elements within a table element. HTML parsers insert the colgroup element, but
XML parsers do not, thus creating different DOMs. [[

At least, I did. I even created this Live DOM viewer test to show that it is
not the case: http://tinyurl.com/colgroup

What you wanted to say was that <colgroup> is an obligatory wrapper aroun any
<col>. The confusing wordings are "uses", "explicit" and "insert".  Perhaps the
word "code" could been used somewhere? The wording should also imply clear that
it can be more than one colgroup in the same table.

I suggest this:

]] In the code of polyglot markup, a col element always has to occur wrapped
inside a colgroup element. In HTML, if in the code a group of one or more
adjacent col elements are not explicitly wrapped inside a colgroup element,
then the parser will create a new colgroup element and wrap around them. XML
parsers will not do the same thing, thus creating different DOMs.[[

In the same go, place also fix the text about <tbody>. You should say that
authors must use either tbody, thead or tfoot. I suggest this:

]] In the code of polyglot markup, a tr element always has to occur wrapped
inside a tbody, thead or tfoot element. In HTML, if in the code a group of one
or more adjacent tr elements are not explictly wrapped inside a tbody, thead or
tfoot element, then the parser will create a new tbody element and wrap around
them. XML parsers will not do the same thing, thus creating different DOMs.[[

Another thing: the minimal document example, you have this <html> start tag:

<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">

Please EITHER clarify that you mean a minimal ENGLISH document. OR replace
lang="en" xml:lang="en" with empty attributes (which per HTML5 and XML means
that no language has been set):

<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">

(We discussed another place that ther should always be a lang/xml:lang
attribute, so it is OK for me to include the lang/xml:lang attributes.)

-- 
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 Thursday, 17 March 2011 01:25:40 UTC