html5/spec Overview.html,1.1909,1.1910

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv23256

Modified Files:
	Overview.html 
Log Message:
Filling in the rendering section: moving stuff around. (whatwg r2740)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1909
retrieving revision 1.1910
diff -u -d -r1.1909 -r1.1910
--- Overview.html	2 Feb 2009 11:42:55 -0000	1.1909
+++ Overview.html	2 Feb 2009 11:53:16 -0000	1.1910
@@ -972,8 +972,14 @@
      <li><a href=#the-marquee-element><span class=secno>10.4.5 </span>The <code>marquee</code> element</a></li>
      <li><a href=#the-hr-element-0><span class=secno>10.4.6 </span>The <code>hr</code> element</a></li>
      <li><a href=#the-br-element-0><span class=secno>10.4.7 </span>The <code>br</code> element</a></li>
-     <li><a href=#frames><span class=secno>10.4.8 </span>Frames</a></ol></li>
-   <li><a href=#other><span class=secno>10.5 </span>Other</a></ol></li>
+     <li><a href=#frames><span class=secno>10.4.8 </span>Frames</a></li>
+     <li><a href=#images-0><span class=secno>10.4.9 </span>Images</a></li>
+     <li><a href=#fragment-identifiers><span class=secno>10.4.10 </span>Fragment identifiers</a></ol></li>
+   <li><a href=#interactive-media><span class=secno>10.5 </span>Interactive media</a>
+    <ol>
+     <li><a href=#hit-testing><span class=secno>10.5.1 </span>Hit testing</a></ol></li>
+   <li><a href=#print-media><span class=secno>10.6 </span>Print media</a></li>
+   <li><a href=#interaction-with-css><span class=secno>10.7 </span>Interaction with CSS</a></ol></li>
  <li><a href=#obsolete-features><span class=secno>11 </span>Obsolete features</a>
   <ol>
    <li><a href=#self-contained-features-0><span class=secno>11.1 </span>Self-contained features</a>
@@ -45965,7 +45971,28 @@
 
    </li>
 
-  </ol><h2 id=rendering><span class=secno>10 </span>Rendering</h2><p><em>This section all its subsections are non-normative.</em><h3 id=introduction-8><span class=secno>10.1 </span>Introduction</h3><p>User agents are not required present HTML documents in any
+  </ol><h2 id=rendering><span class=secno>10 </span>Rendering</h2><p><em>This section all its subsections are non-normative.</em></p><!-- XXX
+
+    figure/legend
+    iframe, embed, object, applet, video, audio, canvas
+
+    Default UI
+      link: click
+      mark: skip to next mark element
+      title attribute: tooltip
+      cite attribute on q, blockquote, ins, del: on hover, show link
+      ...
+
+    Define how to determine what element is under the cursor, unless
+    the CSS group has finally gotten around to defining that before we
+    get to it
+
+    Extensions to CSS
+      for drag and drop
+      for datagrid
+      ...
+
+--><h3 id=introduction-8><span class=secno>10.1 </span>Introduction</h3><p>User agents are not required present HTML documents in any
   particular way. This section merely provides a set of suggestions
   for rendering HTML documents that, if followed, are likely to lead
   to a user experience that closely resembles the experience intended
@@ -46006,7 +46033,16 @@
 tr { display: table-row; }
 td, th { display: table-cell; }
 
-li { display: list-item; }</pre><!-- XXX ruby, rt, rp --><!-- del, ins, and map are inline. --><p>For the purposes of the CSS table model, the <code><a href=#the-col-element>col</a></code>
+li { display: list-item; }</pre><!-- XXX ruby, rt, rp 
+  > * note on rt rendering
+  > 
+  > Since there are a number of documents with ruby but without rp, when you
+  > write the rendering section, please include an advice for user agents
+  > that do not support "correct" ruby rendering to render something like
+  > "(" and ")" before and after ruby text (using, e.g., CSS ::before and
+  > ::after) even when there are no rp elements. Otherwise, reading Web
+  > pages without rp is very annoying.
+  --><!-- del, ins, and map are inline. --><p>For the purposes of the CSS table model, the <code><a href=#the-col-element>col</a></code>
   element is to be treated as if it was present as many times as its
   <code title=attr-col-span><a href=#attr-col-span>span</a></code> attribute <a href=#rules-for-parsing-non-negative-integers title="rules
   for parsing non-negative integers">specifies</a>.<p>For the purposes of the CSS table model, the
@@ -46215,45 +46251,27 @@
    <!-- XXX button, select, textarea, bb -->
 
 
-  </dl><p class=XXX>...<h4 id=the-datagrid-element><span class=secno>10.4.3 </span>The <code><a href=#datagrid>datagrid</a></code> element</h4><p class=XXX>...<h4 id=rendering-and-menus-toolbars><span class=secno>10.4.4 </span>Rendering and menus/toolbars</h4><h5 id=the-icon-property><span class=secno>10.4.4.1 </span>The 'icon' property</h5><p>UAs should use the command's Icon as the default generic icon
+  </dl><p class=XXX>...<h4 id=the-datagrid-element><span class=secno>10.4.3 </span>The <code><a href=#datagrid>datagrid</a></code> element</h4><p class=XXX>This section will probably include details on
+  how to render DATAGRID (including <span id=datagridPseudos>its
+  pseudo-elements</span>), drag-and-drop, etc, in a visual medium, in
+  concert with CSS.<h4 id=rendering-and-menus-toolbars><span class=secno>10.4.4 </span>Rendering and menus/toolbars</h4><h5 id=the-icon-property><span class=secno>10.4.4.1 </span>The 'icon' property</h5><p>UAs should use the command's Icon as the default generic icon
   provided by the user agent when the 'icon' property computes to
   'auto' on an element that either defines a command or refers to one
   using the <code title=command-attribute>command</code> attribute,
   but when the property computes to an actual image, it should use
-  that image instead.<h4 id=the-marquee-element><span class=secno>10.4.5 </span>The <code><a href=#the-marquee-element-0>marquee</a></code> element</h4><p class=XXX>...<h4 id=the-hr-element-0><span class=secno>10.4.6 </span>The <code><a href=#the-hr-element>hr</a></code> element</h4><p class=XXX>...<h4 id=the-br-element-0><span class=secno>10.4.7 </span>The <code><a href=#the-br-element>br</a></code> element</h4><p class=XXX>...<h4 id=frames><span class=secno>10.4.8 </span>Frames</h4><p class=XXX>...<h3 id=other><span class=secno>10.5 </span>Other</h3><!-- XXX
-
-    figure/legend
-    iframe, embed, object, applet, video, audio, canvas
-
-    Default UI
-      link: click
-      mark: skip to next mark element
-      title attribute: tooltip
-      cite attribute on q, blockquote, ins, del: on hover, show link
-      ...
-
-    Define how to determine what element is under the cursor, unless
-    the CSS group has finally gotten around to defining that before we
-    get to it
-
-    Extensions to CSS
-      for drag and drop
-      for datagrid
-      ...
-
-> * note on rt rendering
-> 
-> Since there are a number of documents with ruby but without rp, when you
-> write the rendering section, please include an advice for user agents
-> that do not support "correct" ruby rendering to render something like
-> "(" and ")" before and after ruby text (using, e.g., CSS ::before and
-> ::after) even when there are no rp elements. Otherwise, reading Web
-> pages without rp is very annoying.
-
-      img - how to handle alt text, img in link (no border)... Define
-      that either the src="" is shown (as an image) or the alt="" is
-      shown (inline) but should not ever have both at once.
+  that image instead.<h4 id=the-marquee-element><span class=secno>10.4.5 </span>The <code><a href=#the-marquee-element-0>marquee</a></code> element</h4><p class=XXX>...<h4 id=the-hr-element-0><span class=secno>10.4.6 </span>The <code><a href=#the-hr-element>hr</a></code> element</h4><p class=XXX>...<h4 id=the-br-element-0><span class=secno>10.4.7 </span>The <code><a href=#the-br-element>br</a></code> element</h4><p class=XXX>...<h4 id=frames><span class=secno>10.4.8 </span>Frames</h4><p class=XXX>...<h4 id=images-0><span class=secno>10.4.9 </span>Images</h4><p class=XXX>...</p><!--
+    img - how to handle alt text, img in link (no border)... Define
+    that either the src="" is shown (as an image) or the alt="" is
+    shown (inline) but should not ever have both at once.
+  --><p class=XXX>Terms that need to be defined include: <dfn id=sizing-of-embedded-content>sizing
+  of embedded content</dfn><h4 id=fragment-identifiers><span class=secno>10.4.10 </span>Fragment identifiers</h4><p class=XXX>(need to remove "must" and reword) CSS UAs in visual
+  media must, when scrolling a page to a fragment identifier, align
+  the top of the viewport with the target element's top border
+  edge.</p><!-- XXX horiz pos given bidi, and not scrolling when not
+  required to?  --><h3 id=interactive-media><span class=secno>10.5 </span>Interactive media</h3><h4 id=hit-testing><span class=secno>10.5.1 </span>Hit testing</h4><p class=XXX>this should really be in a CSS spec -- hot to decide
+  which element is under the cursor --&gt;
 
+<!--
 
 HIT TESTING TRANSPARENCY
 
@@ -46315,37 +46333,14 @@
    I. The event goes to X. STOP
 
 
-  --><p class=XXX>This section will probably include details on
-  how to render DATAGRID (including <span id=datagridPseudos>its
-  pseudo-elements</span>), drag-and-drop, etc, in a visual medium, in
-  concert with CSS. Terms that need to be defined include: <dfn id=sizing-of-embedded-content>sizing
-  of embedded content</dfn><p>CSS UAs in visual media must, when scrolling a page to a fragment
-  identifier, align the top of the viewport with the target element's
-  top border edge.</p><!-- XXX horiz pos given bidi, and not
-  scrolling when not required to? --><!--
-  <h4>Section headers</h4>
-
-  <p>For <code>h1</code> elements, CSS-aware visual user agents should
-  derive the size of the header from the level of <code>section</code>
-  nesting. This effect should be achieved by including the following
-  rules, or their equivalent, in the UA's user agent style sheet:</p>
-
-  <pre>@namespace xh url(http://www.w3.org/1999/xhtml);
-xh|section xh|h1 { /* same styles as h2 */ }
-xh|section xh|section xh|h1 { /* same styles as h4 */ }
-xh|section xh|section xh|section xh|h1 { /* same styles as h4 */ }
-xh|section xh|section xh|section xh|section xh|h1 { /* same styles as h5 */ }
-xh|section xh|section xh|section xh|section xh|section xh|h1 { /* same styles as h6 */ }</pre>
+  -->
 
-  <p>Authors should use <code>h1</code> elements to denote headers in
-  sections. Authors may instead use <code>h2</code> ...
-  <code>h6</code> elements, for backwards compatibility with user
-  agents that do not support <code>section</code> elements.</p>
 
---><p class=XXX> must define letting the user "<dfn id=obtain-a-physical-form>obtain a
+  <h3 id=print-media><span class=secno>10.6 </span>Print media</h3><p class=XXX> must define letting the user "<dfn id=obtain-a-physical-form>obtain a
   physical form</dfn> (or a representation of a physical form)" of a
   document (printing) and what this means for the UA, in particular
-  creating a new view for the print media.<p class=XXX>Must define that in CSS, tag and attribute
+  creating a new view for the print media.<h3 id=interaction-with-css><span class=secno>10.7 </span>Interaction with CSS</h3><!-- XXX this should be normative, so we'll have to move it out of
+  this section --><p class=XXX>Must define that in CSS, tag and attribute
   names in HTML documents, and class names in quirks mode documents,
   are case-insensitive, as well as saying which attribute values must
   be compared case-insensitively.<h2 id=obsolete-features><span class=secno>11 </span>Obsolete features</h2><p>Authors and documents must not use the features listed in this

Received on Monday, 2 February 2009 11:53:31 UTC