W3C home > Mailing lists > Public > public-html-diffs@w3.org > July 2009

mike: filled in descriptions for some global attributes

From: poot <cvsmail@w3.org>
Date: Thu, 30 Jul 2009 16:44:39 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20090730074439.4CBF92BC69@toro.w3.mag.keio.ac.jp>
mike: filled in descriptions for some global attributes

http://dev.w3.org/cvsweb/html5/markup/Overview.html?r1=1.331&r2=1.332&f=h

===================================================================
RCS file: /sources/public/html5/markup/Overview.html,v
retrieving revision 1.331
retrieving revision 1.332
diff -u -d -r1.331 -r1.332
--- Overview.html	29 Jul 2009 11:23:41 -0000	1.331
+++ Overview.html	30 Jul 2009 07:44:13 -0000	1.332
@@ -9,7 +9,7 @@
 <body>
 <div class="head">
 <h1>HTML 5: The Markup Language</h1>
-<h2>Editor&#8217;s Draft <em>29 July 2009</em>
+<h2>Editor&#8217;s Draft <em>30 July 2009</em>
 </h2>
 <dl>
 <dt>Latest Editor&#8217;s Draft:</dt>
@@ -42,7 +42,7 @@
     
     
     <p>
-        This document is the 29 July 2009 Editor&#8217;s Draft of 
+        This document is the 30 July 2009 Editor&#8217;s Draft of 
         <cite>HTML 5: The Markup Language</cite>.
       </p>
     <p>
@@ -660,11 +660,8 @@
 <li id="shared-attributes-toc">
 <a href="shared-attributes.html#shared-attributes">10. Other shared attributes</a>
 <ul>
-<li id="shared-hyperlink-attrs-toc">
-<a href="shared-attributes.html#shared-hyperlink-attrs">10.1. Hyperlink attributes</a>
-</li>
 <li id="common-form-attrs-toc">
-<a href="shared-attributes.html#common-form-attrs">10.2. Form attributes</a>
+<a href="shared-attributes.html#common-form-attrs">10.1. Form attributes</a>
 </li>
 </ul>
 </li>

Index: common-attributes.html
===================================================================
RCS file: /sources/public/html5/markup/common-attributes.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- common-attributes.html	29 Jul 2009 05:38:09 -0000	1.11
+++ common-attributes.html	30 Jul 2009 07:44:13 -0000	1.12
@@ -27,8 +27,7 @@
         <h2 class="common-subhead">9.1. Basic attributes <a class="hash" href="#basic-attrs">#</a> <a class="toc-bak" href="Overview.html#basic-attrs-toc">T</a></h2><div id="common.attrs.basic-mdl">
         
           <div class="content-models">
-            <p><span class="common-pattern-name"><a href="common-attributes.html#common.attrs.basic" id="common.attrs.basic">common.attrs.basic</a></span> = (<a class="ref" href="common-attributes.html#common.attrs.id" title="common.attrs.id">id</a>
-   | <a class="ref" href="common-attributes.html#common.attrs.xml-id" title="common.attrs.xml-id">xml:id</a>)?
+            <p><span class="common-pattern-name"><a href="common-attributes.html#common.attrs.basic" id="common.attrs.basic">common.attrs.basic</a></span> = <a class="ref" href="common-attributes.html#common.attrs.id" title="common.attrs.id">id</a>
   &amp; <a class="ref" href="common-attributes.html#common.attrs.class" title="common.attrs.class">class</a>?
   &amp; <a class="ref" href="common-attributes.html#common.attrs.title" title="common.attrs.title">title</a>?
   &amp; <a class="ref" href="common-attributes.html#common.attrs.xmlbase" title="common.attrs.xmlbase">xml:base</a>?
@@ -40,28 +39,34 @@
             <dt><a class="attribute-name" id="common.attrs.id" title="common.attrs.id" href="common-attributes.html#common.attrs.id">id</a><span class="attr-values"> = 
       <a class="ref" href="datatypes.html#common.data.id" title="common.data.id">id</a>
     </span> </dt>
-            <dd><i class="TK">(detailed attribute description to come)</i></dd>
-          
-            <dt><a class="attribute-name" id="common.attrs.xml-id" title="common.attrs.xml-id" href="common-attributes.html#common.attrs.xml-id">xml:id</a><span class="attr-values"> =  xsd:NCName </span> </dt>
-            <dd><i class="TK">(detailed attribute description to come)</i></dd>
+            <dd>A unique identifier for the element.</dd>
           
             <dt><a class="attribute-name" id="common.attrs.class" title="common.attrs.class" href="common-attributes.html#common.attrs.class">class</a><span class="attr-values"> = 
       <a class="ref" href="datatypes.html#common.data.tokens" title="common.data.tokens">tokens</a>
     </span> </dt>
-            <dd><i class="TK">(detailed attribute description to come)</i></dd>
+            <dd>A list of one or more classifications to which the
+        element belongs.</dd>
           
             <dt><a class="attribute-name" id="common.attrs.title" title="common.attrs.title" href="common-attributes.html#common.attrs.title">title</a><span class="attr-values"> = 
       <a class="ref" href="syntax.html#normal-character-data">normal-character-data</a>
     </span> </dt>
-            <dd><i class="TK">(detailed attribute description to come)</i></dd>
+            <dd>Advisory information associated with the element.</dd>
           
             <dt><a class="attribute-name" id="common.attrs.xmlbase" title="common.attrs.xmlbase" href="common-attributes.html#common.attrs.xmlbase">xml:base</a><span class="attr-values"> = 
       <a class="ref" href="datatypes.html#common.data.uri" title="common.data.uri">uri</a>
     </span> </dt>
-            <dd><i class="TK">(detailed attribute description to come)</i></dd>
+            <dd>As defined in the XML Base specification
+        <a href="references.html#refsXMLBase">[XMLBase]</a>.</dd><dd>This attribute should only be used with 
+        <a href="documents.html#syntax-document-xml">documents in the XML syntax</a>.
+        It must not be used in 
+        <a href="documents.html#syntax-document-html">documents in the HTML syntax</a>.</dd>
           
             <dt><a class="attribute-name" id="common.attrs.xmlspace" title="common.attrs.xmlspace" href="common-attributes.html#common.attrs.xmlspace">xml:space</a><span class="attr-values"> =  "preserve" </span> </dt>
-            <dd><i class="TK">(detailed attribute description to come)</i></dd>
+            <dd>As defined in the XML specification
+        <a href="references.html#refsXML">[XML]</a>.</dd><dd>This attribute should only be used with 
+        <a href="documents.html#syntax-document-xml">documents in the XML syntax</a>.
+        It must not be used in 
+        <a href="documents.html#syntax-document-html">documents in the HTML syntax</a>.</dd>
           
         </dl></div></div><div id="i18n-attrs" class="section">
         <h2 class="common-subhead">9.2. Internationalization attributes <a class="hash" href="#i18n-attrs">#</a> <a class="toc-bak" href="Overview.html#i18n-attrs-toc">T</a></h2><div id="common.attrs.i18n-mdl">

Index: references.html
===================================================================
RCS file: /sources/public/html5/markup/references.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -d -r1.10 -r1.11
--- references.html	20 Jul 2009 22:44:23 -0000	1.10
+++ references.html	30 Jul 2009 07:44:13 -0000	1.11
@@ -79,6 +79,9 @@
     <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml-20060816/">Extensible Markup Language (XML) 1.0 (Fourth
           Edition)</a></cite>. Tim Bray, Jean Paoli, C. M.
       Sperberg-McQueen, Eve Maler, Fran&#231;ois Yergeau. 16 August 2006.</dd>
+    <dt><dfn id="refsXMLBase">[XMLBase]</dfn></dt>
+    <dd><cite><a href="http://www.w3.org/TR/2009/REC-xmlbase-20090128/">XML Base (Second Edition)</a></cite>.
+      Jonathan Marsh, Richard Tobin. 28 January 2009.</dd>
     <dt><dfn id="refsXML">[XMLNS]</dfn></dt>
     <dd><cite><a href="http://www.w3.org/TR/2006/REC-xml-names-20060816/">Namespaces in XML 1.0 (Second Edition)</a></cite>.
       Tim Bray, Dave Hollander, Andrew Layman, Richard Tobin.

Index: patch-schema
===================================================================
RCS file: /sources/public/html5/markup/patch-schema,v
retrieving revision 1.67
retrieving revision 1.68
diff -u -d -r1.67 -r1.68
--- patch-schema	29 Jul 2009 12:16:39 -0000	1.67
+++ patch-schema	30 Jul 2009 07:44:13 -0000	1.68
@@ -713,7 +713,29 @@
  		)
  
  # #####################################################################
-@@ -359,16 +359,8 @@
+@@ -103,9 +103,7 @@
+ 	)
+ 
+ common.attrs.basic =
+-	(	(	common.attrs.id
+-		|	common.attrs.xml-id
+-		)? # REVISIT assuming only either one is allowed
++	(	common.attrs.id
+ 	&	common.attrs.class?
+ 	&	common.attrs.title?
+ 	&	common.attrs.base?
+@@ -115,10 +113,6 @@
+ 		attribute id {
+ 			common.data.id
+ 		}
+-	common.attrs.xml-id =
+-		attribute xml:id {
+-			xsd:NCName
+-		} & XMLonly
+ 	common.attrs.class =
+ 		attribute class {
+ 			common.data.tokens
+@@ -359,16 +353,8 @@
    common.data.zero =
      w:zero
  

Index: spec.html
===================================================================
RCS file: /sources/public/html5/markup/spec.html,v
retrieving revision 1.70
retrieving revision 1.71
diff -u -d -r1.70 -r1.71
--- spec.html	29 Jul 2009 12:26:53 -0000	1.70
+++ spec.html	30 Jul 2009 07:44:13 -0000	1.71
@@ -9,7 +9,7 @@
 <body>
 <div class="head">
 <h1>HTML 5: The Markup Language</h1>
-<h2>Editor&#8217;s Draft <em>29 July 2009</em>
+<h2>Editor&#8217;s Draft <em>30 July 2009</em>
 </h2>
 <dl>
 <dt>Latest Editor&#8217;s Draft:</dt>
@@ -41,7 +41,7 @@
     
     
     <p>
-        This document is the 29 July 2009 Editor&#8217;s Draft of 
+        This document is the 30 July 2009 Editor&#8217;s Draft of 
         <cite>HTML 5: The Markup Language</cite>.
       </p>
     <p>
@@ -659,11 +659,8 @@
 <li id="shared-attributes-toc">
 <a href="#shared-attributes">10. Other shared attributes</a>
 <ul>
-<li id="shared-hyperlink-attrs-toc">
-<a href="#shared-hyperlink-attrs">10.1. Hyperlink attributes</a>
-</li>
 <li id="common-form-attrs-toc">
-<a href="#common-form-attrs">10.2. Form attributes</a>
+<a href="#common-form-attrs">10.1. Form attributes</a>
 </li>
 </ul>
 </li>
@@ -14364,8 +14361,7 @@
 <div id="common.attrs.basic-mdl">
         
           <div class="content-models">
-            <p><span class="common-pattern-name"><a href="#common.attrs.basic" id="common.attrs.basic">common.attrs.basic</a></span> = (<a class="ref" href="#common.attrs.id" title="common.attrs.id">id</a>
-   | <a class="ref" href="#common.attrs.xml-id" title="common.attrs.xml-id">xml:id</a>)?
+            <p><span class="common-pattern-name"><a href="#common.attrs.basic" id="common.attrs.basic">common.attrs.basic</a></span> = <a class="ref" href="#common.attrs.id" title="common.attrs.id">id</a>
   &amp; <a class="ref" href="#common.attrs.class" title="common.attrs.class">class</a>?
   &amp; <a class="ref" href="#common.attrs.title" title="common.attrs.title">title</a>?
   &amp; <a class="ref" href="#common.attrs.xmlbase" title="common.attrs.xmlbase">xml:base</a>?
@@ -14378,33 +14374,40 @@
 <a class="attribute-name" id="common.attrs.id" title="common.attrs.id" href="#common.attrs.id">id</a><span class="attr-values"> = 
       <a class="ref" href="#common.data.id" title="common.data.id">id</a>
     </span> </dt>
-            <dd><i class="TK">(detailed attribute description to come)</i></dd>
-          
-            <dt>
-<a class="attribute-name" id="common.attrs.xml-id" title="common.attrs.xml-id" href="#common.attrs.xml-id">xml:id</a><span class="attr-values"> =  xsd:NCName </span> </dt>
-            <dd><i class="TK">(detailed attribute description to come)</i></dd>
+            <dd>A unique identifier for the element.</dd>
           
             <dt>
 <a class="attribute-name" id="common.attrs.class" title="common.attrs.class" href="#common.attrs.class">class</a><span class="attr-values"> = 
       <a class="ref" href="#common.data.tokens" title="common.data.tokens">tokens</a>
     </span> </dt>
-            <dd><i class="TK">(detailed attribute description to come)</i></dd>
+            <dd>A list of one or more classifications to which the
+        element belongs.</dd>
           
             <dt>
 <a class="attribute-name" id="common.attrs.title" title="common.attrs.title" href="#common.attrs.title">title</a><span class="attr-values"> = 
       <a class="ref" href="#normal-character-data">normal-character-data</a>
     </span> </dt>
-            <dd><i class="TK">(detailed attribute description to come)</i></dd>
+            <dd>Advisory information associated with the element.</dd>
           
             <dt>
 <a class="attribute-name" id="common.attrs.xmlbase" title="common.attrs.xmlbase" href="#common.attrs.xmlbase">xml:base</a><span class="attr-values"> = 
       <a class="ref" href="#common.data.uri" title="common.data.uri">uri</a>
     </span> </dt>
-            <dd><i class="TK">(detailed attribute description to come)</i></dd>
+            <dd>As defined in the XML Base specification
+        <a href="#refsXMLBase">[XMLBase]</a>.</dd>
+<dd>This attribute should only be used with 
+        <a href="#syntax-document-xml">documents in the XML syntax</a>.
+        It must not be used in 
+        <a href="#syntax-document-html">documents in the HTML syntax</a>.</dd>
           
             <dt>
 <a class="attribute-name" id="common.attrs.xmlspace" title="common.attrs.xmlspace" href="#common.attrs.xmlspace">xml:space</a><span class="attr-values"> =  "preserve" </span> </dt>
-            <dd><i class="TK">(detailed attribute description to come)</i></dd>
+            <dd>As defined in the XML specification
+        <a href="#refsXML">[XML]</a>.</dd>
+<dd>This attribute should only be used with 
+        <a href="#syntax-document-xml">documents in the XML syntax</a>.
+        It must not be used in 
+        <a href="#syntax-document-html">documents in the HTML syntax</a>.</dd>
           
         </dl>
 </div>
@@ -14696,13 +14699,8 @@
     <div id="shared-attributes" class="section">
         <h2>10. Other shared attributes <a class="hash" href="#shared-attributes">#</a> <a class="toc-bak" href="#shared-attributes-toc">T</a>
 </h2>
-    <div id="shared-hyperlink-attrs" class="section">
-        <h2>10.1. Hyperlink attributes <a class="hash" href="#shared-hyperlink-attrs">#</a> <a class="toc-bak" href="#shared-hyperlink-attrs-toc">T</a>
-</h2>
-        <dl class="attr-defs"></dl>
-</div>
     <div id="common-form-attrs" class="section">
-        <h2>10.2. Form attributes <a class="hash" href="#common-form-attrs">#</a> <a class="toc-bak" href="#common-form-attrs-toc">T</a>
+        <h2>10.1. Form attributes <a class="hash" href="#common-form-attrs">#</a> <a class="toc-bak" href="#common-form-attrs-toc">T</a>
 </h2>
         <div class="content-model">
 <span class="common-pattern-name"><dfn id="common-form.attrs">common-form.attrs</dfn></span> = (<a class="ref" href="#common-form.attrs.name" title="common-form.attrs.name">name</a>?
@@ -15495,6 +15493,10 @@
 <cite><a href="http://www.w3.org/TR/2006/REC-xml-20060816/">Extensible Markup Language (XML) 1.0 (Fourth
           Edition)</a></cite>. Tim Bray, Jean Paoli, C. M.
       Sperberg-McQueen, Eve Maler, Fran&#231;ois Yergeau. 16 August 2006.</dd>
+    <dt><dfn id="refsXMLBase">[XMLBase]</dfn></dt>
+    <dd>
+<cite><a href="http://www.w3.org/TR/2009/REC-xmlbase-20090128/">XML Base (Second Edition)</a></cite>.
+      Jonathan Marsh, Richard Tobin. 28 January 2009.</dd>
     <dt><dfn id="refsXML">[XMLNS]</dfn></dt>
     <dd>
 <cite><a href="http://www.w3.org/TR/2006/REC-xml-names-20060816/">Namespaces in XML 1.0 (Second Edition)</a></cite>.

Index: shared-attributes.html
===================================================================
RCS file: /sources/public/html5/markup/shared-attributes.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- shared-attributes.html	29 Jul 2009 12:16:39 -0000	1.9
+++ shared-attributes.html	30 Jul 2009 07:44:13 -0000	1.10
@@ -13,13 +13,8 @@
 </div>
 <div id="shared-attributes" class="section">
         <h2>10. Other shared attributes <a class="hash" href="#shared-attributes">#</a> <a class="toc-bak" href="Overview.html#shared-attributes-toc">T</a></h2>
-    <div id="shared-hyperlink-attrs" class="section">
-        <h2>10.1. Hyperlink attributes <a class="hash" href="#shared-hyperlink-attrs">#</a> <a class="toc-bak" href="Overview.html#shared-hyperlink-attrs-toc">T</a></h2>
-        <dl class="attr-defs">
-        </dl>
-    </div>
     <div id="common-form-attrs" class="section">
-        <h2>10.2. Form attributes <a class="hash" href="#common-form-attrs">#</a> <a class="toc-bak" href="Overview.html#common-form-attrs-toc">T</a></h2>
+        <h2>10.1. Form attributes <a class="hash" href="#common-form-attrs">#</a> <a class="toc-bak" href="Overview.html#common-form-attrs-toc">T</a></h2>
         <div class="content-model"><span class="common-pattern-name"><dfn id="common-form.attrs">common-form.attrs</dfn></span> = (<a class="ref" href="shared-attributes.html#common-form.attrs.name" title="common-form.attrs.name">name</a>?
    &amp; <a class="ref" href="shared-attributes.html#common-form.attrs.disabled" title="common-form.attrs.disabled">disabled</a>?)
   &amp; <a class="ref" href="shared-attributes.html#common-form.attrs.form" title="common-form.attrs.form">form</a>? <a class="hash" href="shared-attributes.html#common-form.attrs">#</a>
Received on Thursday, 30 July 2009 07:45:17 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 06:14:07 GMT