W3C home > Mailing lists > Public > public-html-commits@w3.org > June 2009

html5/spec Overview.html,1.2328,1.2329

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 02 Jun 2009 02:57:09 +0000
To: public-html-commits@w3.org
Message-Id: <E1MBKBa-00066r-3W@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv23463

Modified Files:
	Overview.html 
Log Message:
Make xml:lang requirements more clear. (bug 6949) (whatwg r3175)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2328
retrieving revision 1.2329
diff -u -d -r1.2328 -r1.2329
--- Overview.html	2 Jun 2009 02:37:52 -0000	1.2328
+++ Overview.html	2 Jun 2009 02:57:06 -0000	1.2329
@@ -385,8 +385,7 @@
       <ol>
        <li><a href="#the-id-attribute"><span class="secno">3.3.3.1 </span>The <code>id</code> attribute</a></li>
        <li><a href="#the-title-attribute"><span class="secno">3.3.3.2 </span>The <code>title</code> attribute</a></li>
-       <li><a href="#the-lang-and-xml:lang-attributes"><span class="secno">3.3.3.3 </span>The <code>lang</code> and <code>xml:lang</code>
-  attributes</a></li>
+       <li><a href="#the-lang-and-xml:lang-attributes"><span class="secno">3.3.3.3 </span>The <code title="attr-lang">lang</code> and <code title="attr-xml-lang">xml:lang</code> attributes</a></li>
        <li><a href="#the-xml:base-attribute-xml-only"><span class="secno">3.3.3.4 </span>The <code>xml:base</code>
   attribute (XML only)</a></li>
        <li><a href="#the-dir-attribute"><span class="secno">3.3.3.5 </span>The <code>dir</code> attribute</a></li>
@@ -7256,7 +7255,7 @@
   attribute.<h3 id="elements"><span class="secno">3.3 </span>Elements</h3><h4 id="semantics-0"><span class="secno">3.3.1 </span>Semantics</h4><p>Elements, attributes, and attribute values in HTML are defined
   (by this specification) to have certain meanings (semantics). For
   example, the <code><a href="#the-ol-element">ol</a></code> element represents an ordered list, and
-  the <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attribute represents the
+  the <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute represents the
   language of the content.<p>Authors must not use elements, attributes, and attribute values
   for purposes other than their appropriate intended semantic
   purpose.<div class="example">
@@ -7461,7 +7460,7 @@
    <li><code title="attr-id"><a href="#the-id-attribute">id</a></code></li>
    <li><code title="attr-item"><a href="#items:-the-item-attribute">item</a></code></li>
    <li><code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code></li>
-   <li><code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code></li>
+   <li><code title="attr-lang"><a href="#attr-lang">lang</a></code></li>
    <li><code title="attr-itemprop"><a href="#names:-the-itemprop-attribute">itemprop</a></code></li>
    <li><code title="attr-spellcheck"><a href="#attr-spellcheck">spellcheck</a></code></li>
    <li><code title="attr-style"><a href="#the-style-attribute">style</a></code></li>
@@ -7602,45 +7601,51 @@
   must <a href="#reflect">reflect</a> the <code title="attr-title"><a href="#the-title-attribute">title</a></code>
   content attribute.</p>
 
-  </div><h5 id="the-lang-and-xml:lang-attributes"><span class="secno">3.3.3.3 </span>The <dfn title="attr-lang"><code>lang</code></dfn> and <dfn title="attr-xml-lang"><code>xml:lang</code></dfn>
-  attributes</h5><p>The <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attribute specifies the
-  primary <dfn id="language">language</dfn> for the element's contents and for any
-  of the element's attributes that contain text. Its value must be a
-  valid RFC 3066 language code, or the empty string. <a href="#references">[RFC3066]</a><p>The <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attribute (that
-  is, the <code title="">lang</code> attribute with the <code title="">xml</code> prefix in the <code title="">http://www.w3.org/XML/1998/namespace</code> namespace) is
-  defined in XML. <a href="#references">[XML]</a><p>If these attributes are omitted from an element, then the
+  </div><h5 id="the-lang-and-xml:lang-attributes"><span class="secno">3.3.3.3 </span>The <code title="attr-lang"><a href="#attr-lang">lang</a></code> and <code title="attr-xml-lang"><a href="#attr-xml-lang">xml:lang</a></code> attributes</h5><p>The <dfn id="attr-lang" title="attr-lang"><code>lang</code></dfn> attribute (in
+  no namespace) specifies the primary <dfn id="language">language</dfn> for the
+  element's contents and for any of the element's attributes that
+  contain text. Its value must be a valid RFC 3066 language code, or
+  the empty string. <a href="#references">[RFC3066]</a><p>The <dfn id="attr-xml-lang" title="attr-xml-lang"><code title="">lang</code></dfn>
+  attribute in the <a href="#xml-namespace">XML namespace</a> is defined in XML. <a href="#references">[XML]</a><p>If these attributes are omitted from an element, then the
   language of this element is the same as the language of its parent
   element, if any. Setting the attribute to the empty string indicates
   that the primary language is unknown.</p><!-- UA conformance
-  requires for this are below --><p>The <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attribute may be used on
-  any <a href="#html-elements" title="HTML elements">HTML element</a>.<p>The <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attribute may be
-  used on <a href="#html-elements">HTML elements</a> in <a href="#xml-documents">XML documents</a>, as
-  well as elements in other namespaces if the relevant specifications
-  allow it (in particular, MathML and SVG allow <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attributes to be specified on
-  their elements). If both the <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code>
-  attribute and the <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code>
-  attribute are specified on the same element, they must have exactly
-  the same value when compared in an <a href="#ascii-case-insensitive">ASCII
-  case-insensitive</a> manner.<p>Authors must not use the <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attribute (that is, the <code title="">lang</code> attribute with the <code title="">xml</code>
-  prefix in the <code title="">http://www.w3.org/XML/1998/namespace</code> namespace) in
-  <a href="#html-documents">HTML documents</a>. To ease migration to and from XHTML,
-  authors may specify an attribute in no namespace with no prefix and
-  with the localname <code title="">xml:lang</code> on <a href="#html-elements">HTML
-  elements</a> in <a href="#html-documents">HTML documents</a>, but such attributes
-  must only be specified if a <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code>
-  attribute is also specified, and both attributes must have the same
+  requires for this are below --><p>The <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute in no namespace
+  may be used on any <a href="#html-elements" title="HTML elements">HTML
+  element</a>.<p>The <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code>
+  attribute in the <span>XML namespace</span></a> may be used on
+  <a href="#html-elements">HTML elements</a> in <a href="#xml-documents">XML documents</a>, as well as
+  elements in other namespaces if the relevant specifications allow it
+  (in particular, MathML and SVG allow <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attributes in the
+  <span>XML namespace</span></a> to be specified on their
+  elements). If both the <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute
+  in no namespace and the <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute in the <span>XML
+  namespace</span></a> are specified on the same element, they must
+  have exactly the same value when compared in an <a href="#ascii-case-insensitive">ASCII
+  case-insensitive</a> manner.<p>Authors must not use the <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute in the <span>XML
+  namespace</span></a> in <a href="#html-documents">HTML documents</a>. To ease
+  migration to and from XHTML, authors may specify an attribute in no
+  namespace with no prefix and with the literal localname "<code title="">xml:lang</code>" on <a href="#html-elements">HTML elements</a> in
+  <a href="#html-documents">HTML documents</a>, but such attributes must only be
+  specified if a <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute in no
+  namespace is also specified, and both attributes must have the same
   value when compared in an <a href="#ascii-case-insensitive">ASCII case-insensitive</a>
   manner.<div class="impl">
 
   <hr><p>To determine the language of a node, user agents must look at the
   nearest ancestor element (including the element itself if the node
-  is an element) that has an <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attribute set or is an <a href="#html-elements" title="HTML elements">HTML element</a> and has a <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attribute set. That attribute
-  specifies the language of the node.</p>
+  is an element) that has a <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute in the <span>XML
+  namespace</span></a> set or is an <a href="#html-elements" title="HTML
+  elements">HTML element</a> and has a <code title="attr-lang"><a href="#attr-lang">lang</a></code> in no namespace attribute set. That
+  attribute specifies the language of the node.</p>
 
-  <p>If both the <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attribute
-  and the <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attribute are set on an
-  element, user agents must use the <code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> attribute, and the <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attribute must be <a href="#ignore" title="ignore">ignored</a> for the purposes of determining the
-  element's language.</p>
+  <p>If both the <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute in no
+  namespace and the <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute in the <span>XML
+  namespace</span></a> are set on an element, user agents must use
+  the <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute
+  in the <span>XML namespace</span></a>, and the <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute in no namespace must be
+  <a href="#ignore" title="ignore">ignored</a> for the purposes of determining
+  the element's language.</p>
 
   <p>If no explicit language is given for the <a href="#root-element">root
   element</a>, but there is a <a href="#document-wide-default-language">document-wide default
@@ -7664,8 +7669,8 @@
   rendering-level concern.)--></p>
 
   <hr><p>The <dfn id="dom-lang" title="dom-lang"><code>lang</code></dfn> DOM attribute
-  must <a href="#reflect">reflect</a> the <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code>
-  content attribute.</p>
+  must <a href="#reflect">reflect</a> the <code title="attr-lang"><a href="#attr-lang">lang</a></code>
+  content attribute in no namespace.</p>
 
   </div><h5 id="the-xml:base-attribute-xml-only"><span class="secno">3.3.3.4 </span>The <dfn title="attr-xml-base"><code>xml:base</code></dfn>
   attribute (XML only)</h5><p>The <code title="attr-xml-base"><a href="#the-xml:base-attribute-xml-only">xml:base</a></code> attribute is
@@ -14418,7 +14423,7 @@
    <dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd>
   </dl><p>The <code><a href="#the-span-element">span</a></code> element doesn't mean anything on its own,
   but can be useful when used together with other attributes,
-  e.g. <code title="attr-class"><a href="#classes">class</a></code>, <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code>, or <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code>. It <a href="#represents">represents</a> its
+  e.g. <code title="attr-class"><a href="#classes">class</a></code>, <code title="attr-lang"><a href="#attr-lang">lang</a></code>, or <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code>. It <a href="#represents">represents</a> its
   children.<h4 id="the-i-element"><span class="secno">4.6.19 </span>The <dfn><code>i</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dd><a href="#phrasing-content-0">Phrasing content</a>.</dd>
@@ -14436,7 +14441,9 @@
   idiomatic phrase from another language, a thought, a ship name, or
   some other prose whose typical typographic presentation is
   italicized.<p>Terms in languages different from the main text should be
-  annotated with <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code> attributes (<code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code> in XML).<div class="example">
+  annotated with <code title="attr-lang"><a href="#attr-lang">lang</a></code> attributes (or,
+  in XML, <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code>
+  attributes in the <span>XML namespace</span></a>).<div class="example">
    <p>The examples below show uses of the <code><a href="#the-i-element">i</a></code> element:</p>
    <pre>&lt;p&gt;The &lt;i class="taxonomy"&gt;Felis silvestris catus&lt;/i&gt; is cute.&lt;/p&gt;
 &lt;p&gt;The term &lt;i&gt;prose content&lt;/i&gt; is defined above.&lt;/p&gt;
@@ -36050,7 +36057,7 @@
    <dt>DOM interface:</dt>
    <dd>Uses <code><a href="#htmlelement">HTMLElement</a></code>.</dd>
   </dl><p>The <code><a href="#the-div-element">div</a></code> element has no special meaning at all. It
-  <a href="#represents">represents</a> its children. It can be used with the <code title="attr-class"><a href="#classes">class</a></code>, <code title="attr-lang"><a href="#the-lang-and-xml:lang-attributes">lang</a></code>/<code title="attr-xml-lang"><a href="#the-lang-and-xml:lang-attributes">xml:lang</a></code>, and <code title="attr-title"><a href="#the-title-attribute">title</a></code> attributes to mark up semantics
+  <a href="#represents">represents</a> its children. It can be used with the <code title="attr-class"><a href="#classes">class</a></code>, <code title="attr-lang"><a href="#attr-lang">lang</a></code>, and <code title="attr-title"><a href="#the-title-attribute">title</a></code> attributes to mark up semantics
   common to a group of consecutive elements.<p class="XXX">Allowing <code><a href="#the-div-element">div</a></code> elements to contain
   phrasing content makes it easy for authors to abuse
   <code><a href="#the-div-element">div</a></code>, using it with the <code>class=""</code> attribute
@@ -55517,7 +55524,8 @@
   corresponding cell in the third column, and the namespace being the
   namespace given in the corresponding cell in the fourth
   column. (This fixes the use of namespaced attributes, in particular
-  <code title="">xml:lang</code>.)</p>
+  <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attributes in
+  the <span>XML namespace</span></a>.)</p>
 
   <table><thead><tr><th> Attribute name <th> Prefix <th> Local name <th> Namespace
    <tbody><tr><td> <code title="">xlink:actuate</code> <td> <code title="">xlink</code> <td> <code title="">actuate</code> <td> <a href="#xlink-namespace">XLink namespace</a>
Received on Tuesday, 2 June 2009 02:57:17 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 2 June 2009 02:57:17 GMT