html5/spec Overview.html,1.1918,1.1919

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

Modified Files:
	Overview.html 
Log Message:
Filling in the rendering section: <body> margins; administrivia (whatwg r2749)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1918
retrieving revision 1.1919
diff -u -d -r1.1918 -r1.1919
--- Overview.html	4 Feb 2009 00:32:34 -0000	1.1918
+++ Overview.html	4 Feb 2009 02:56:20 -0000	1.1919
@@ -45991,11 +45991,14 @@
 
    </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
-  particular way. This section merely provides a set of suggestions
+  </ol><h2 id=rendering><span class=secno>10 </span>Rendering</h2><p><em>User agents are not required present HTML documents in any
+  particular way. However, this section 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
-  by the documents' authors.<p>In general, user agents are expected to support CSS, and many of
+  by the documents' authors. So as to avoid confusion regarding the
+  normativity of this section, RFC2119 terms have not been used.
+  Instead, the term "expected" is used to indicate behavior that will
+  lead to this experience.</em><h3 id=introduction-8><span class=secno>10.1 </span>Introduction</h3><p>In general, user agents are expected to support CSS, and many of
   the suggestions in this section are expressed in CSS terms. User
   agents that use other presentation mechanisms can derive their
   expected behavior by translating from the CSS rules given in this
@@ -46035,18 +46038,14 @@
 li { display: list-item; }</pre><!-- 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><!-- XXX
-  link to dfn instead of parser --><p>For the purposes of the CSS table model, the
+  for parsing non-negative integers">specifies</a>.<p>For the purposes of the CSS table model, the
   <code><a href=#the-colgroup-element>colgroup</a></code> element, if it contains no <code><a href=#the-col-element>col</a></code>
   element, is to be treated as if it had as many such children as its
   <code title=attr-colgroup-span><a href=#attr-colgroup-span>span</a></code> attribute <a href=#rules-for-parsing-non-negative-integers title="rules for parsing non-negative
-  integers">specifies</a>.</p><!-- XXX link to dfn instead of
-  parser --><p>For the purposes of the CSS table model, the <code title=attr-tdth-colspan><a href=#attr-tdth-colspan>colspan</a></code> and <code title=attr-tdth-rowspan><a href=#attr-tdth-rowspan>rowspan</a></code> attributes on
-  <code><a href=#the-td-element>td</a></code> and <code><a href=#the-th-element>th</a></code> elements are expected to provide
-  the <i>special knowledge</i> regarding cells spanning rows and
-  columns.</p><!-- XXX link to dfn instead of parser --><h4 id=margins-and-padding><span class=secno>10.3.3 </span>Margins and padding</h4><pre class=css>@namespace url(http://www.w3.org/1999/xhtml);
-
-body { padding: 8px; }<!-- XXX or margin? -->
+  integers">specifies</a>.<p>For the purposes of the CSS table model, the <code title=attr-tdth-colspan><a href=#attr-tdth-colspan>colspan</a></code> and <code title=attr-tdth-rowspan><a href=#attr-tdth-rowspan>rowspan</a></code> attributes on
+  <code><a href=#the-td-element>td</a></code> and <code><a href=#the-th-element>th</a></code> elements are expected to <a href=#rules-for-parsing-non-negative-integers title="rules for parsing non-negative integers">provide</a> the
+  <i>special knowledge</i> regarding cells spanning rows and
+  columns.<h4 id=margins-and-padding><span class=secno>10.3.3 </span>Margins and padding</h4><pre class=css>@namespace url(http://www.w3.org/1999/xhtml);
 
 blockquote, dir, dl, listing, menu, ol, p, plaintext, pre, ul, xmp {
   margin-top: 1em; margin-bottom: 1em;
@@ -46077,7 +46076,42 @@
 img[align=right] { margin-left: 3px; }</pre><p>When a <code>Document</code> is in <a href=#quirks-mode>quirks mode</a>,
   margins on <a href=#html-elements>HTML elements</a> that collapse with the top or
   bottom of the initial containing block are expected to be collapsed
-  to zero.</p><hr><p class=XXX>...body...</p><!-- marginwidth, marginheight --><hr><p class=XXX>...tables...</p><!-- cellspacing, cellpadding, height, width* (int/%; *width=0 => width:auto); <table hspace/vspace> (int); <table cols>; <table border> (border => border=1); --><!-- td/th width height: 0=>auto; %=>%; n=>px --><!-- col width=int/% span=n --><!-- tbody/thead/tfoot height=int/% (ignore %?) --><!-- tr height=int/% --><h4 id=alignment><span class=secno>10.3.4 </span>Alignment</h4><pre class=css>@namespace url(http://www.w3.org/1999/xhtml);
+  to zero.</p><hr><p>For a <code><a href=#the-body-element>body</a></code> element, the 'margin-top',
+  'margin-right', 'margin-bottom', and 'margin-left' properties are
+  expected to be set by presentational hints from a variety of source,
+  given in the table below in precedence order. If one of the
+  attributes listed is present, then the first such attribute's value
+  is expected to be parsed using the <a href=#rules-for-parsing-non-negative-integers>rules for parsing
+  non-negative integers</a>; if this does not result in an error,
+  then the parsed value is expected to be used as a pixel length for
+  the corresponding property. If no attribute is found, or if the
+  attribute's value cannot be parsed successfully, then a default
+  value of 8px is expected to be used.</p><!-- XXX so, uh, about the cross-site-styling hole below... --><table><thead><tr><th>Property
+     <th>Source
+   <tbody><tr><td rowspan=3>'margin-top'
+     <td><code><a href=#the-body-element>body</a></code> element's <code title=attr-body-marginheight>marginheight</code> attribute
+    <tr><td>The <code><a href=#the-body-element>body</a></code> element's <a href=#container-frame-element>container frame element</a>'s <code title=attr-frame-marginheight>marginheight</code> attribute
+    <tr><td><code><a href=#the-body-element>body</a></code> element's <code title=attr-body-topmargin>topmargin</code> attribute
+   <tbody><tr><td rowspan=3>'margin-right'
+     <td><code><a href=#the-body-element>body</a></code> element's <code title=attr-body-marginwidth>marginwidth</code> attribute
+    <tr><td>The <code><a href=#the-body-element>body</a></code> element's <a href=#container-frame-element>container frame element</a>'s <code title=attr-frame-marginwidth>marginwidth</code> attribute
+    <tr><td><code><a href=#the-body-element>body</a></code> element's <code title=attr-body-rightmargin>rightmargin</code> attribute
+   <tbody><tr><td rowspan=3>'margin-bottom'
+     <td><code><a href=#the-body-element>body</a></code> element's <code title=attr-body-marginheight>marginheight</code> attribute
+    <tr><td>The <code><a href=#the-body-element>body</a></code> element's <a href=#container-frame-element>container frame element</a>'s <code title=attr-frame-marginheight>marginheight</code> attribute
+    <tr><td><code><a href=#the-body-element>body</a></code> element's <code title=attr-body-bottommargin>topmargin</code> attribute
+   <tbody><tr><td rowspan=3>'margin-left'
+     <td><code><a href=#the-body-element>body</a></code> element's <code title=attr-body-marginwidth>marginwidth</code> attribute
+    <tr><td>The <code><a href=#the-body-element>body</a></code> element's <a href=#container-frame-element>container frame element</a>'s <code title=attr-frame-marginwidth>marginwidth</code> attribute
+    <tr><td><code><a href=#the-body-element>body</a></code> element's <code title=attr-body-leftmargin>rightmargin</code> attribute
+  </table><p>If the <code><a href=#the-body-element>body</a></code> element's <code>Document</code>'s
+  <a href=#browsing-context>browsing context</a> is a <a href=#nested-browsing-context>nested browsing
+  context</a>, and the <a href=#browsing-context-container>browsing context container</a> of
+  that <a href=#nested-browsing-context>nested browsing context</a> is a <code>frame</code> or
+  <code><a href=#the-iframe-element>iframe</a></code> element, then the the <dfn id=container-frame-element>container frame
+  element</dfn> of the <code><a href=#the-body-element>body</a></code> element is that
+  <code>frame</code> or <code><a href=#the-iframe-element>iframe</a></code> element. Otherwise, there
+  is no <a href=#container-frame-element>container frame element</a>.</p><hr><p class=XXX>...tables...</p><!-- cellspacing, cellpadding, height, width* (int/%; *width=0 => width:auto); <table hspace/vspace> (int); <table cols>; <table border> (border => border=1); --><!-- td/th width height: 0=>auto; %=>%; n=>px --><!-- col width=int/% span=n --><!-- tbody/thead/tfoot height=int/% (ignore %?) --><!-- tr height=int/% --><h4 id=alignment><span class=secno>10.3.4 </span>Alignment</h4><pre class=css>@namespace url(http://www.w3.org/1999/xhtml);
 
 thead, tbody, tfoot, table &gt; tr { vertical-align: middle; }
 tr, td, th { vertical-align: inherit; }
@@ -46321,7 +46355,10 @@
       for datagrid
       ...
 
-  --><h2 id=obsolete-features><span class=secno>11 </span>Obsolete features</h2><p>Authors and documents must not use the features listed in this
+  --><!-- XXX need to separate the author-level rules from the user-agent-level rules
+       so that the user-level rules can slide between them
+       the spec lists the attributes that should count as presentational:
+       http://www.w3.org/Style/Group/css2-src/cascade.html#preshint --><h2 id=obsolete-features><span class=secno>11 </span>Obsolete features</h2><p>Authors and documents must not use the features listed in this
   section. They are documented to enable user agents to support legacy
   content in an interoperable fashion.</p><!-- XXX Elements that have been dropped: ACRONYM B BASEFONT BLINK BIG
 CENTER DIR DIV FONT FRAME FRAMESET I ISINDEX MARQUEE NOEMBED NOFRAMES

Received on Wednesday, 4 February 2009 02:56:33 UTC