html5/spec Overview.html,1.1928,1.1929

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

Modified Files:
	Overview.html 
Log Message:
Filling in the rendering section: Frames. (whatwg r2759)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1928
retrieving revision 1.1929
diff -u -d -r1.1928 -r1.1929
--- Overview.html	5 Feb 2009 01:55:03 -0000	1.1928
+++ Overview.html	5 Feb 2009 09:18:13 -0000	1.1929
@@ -165,7 +165,8 @@
        <li><a href=#real-numbers><span class=secno>2.4.3.3 </span>Real numbers</a></li>
        <li><a href=#ratios><span class=secno>2.4.3.4 </span>Ratios</a></li>
        <li><a href=#percentages-and-dimensions><span class=secno>2.4.3.5 </span>Percentages and lengths</a></li>
-       <li><a href=#lists-of-integers><span class=secno>2.4.3.6 </span>Lists of integers</a></ol></li>
+       <li><a href=#lists-of-integers><span class=secno>2.4.3.6 </span>Lists of integers</a></li>
+       <li><a href=#lists-of-dimensions><span class=secno>2.4.3.7 </span>Lists of dimensions</a></ol></li>
      <li><a href=#dates-and-times><span class=secno>2.4.4 </span>Dates and times</a>
       <ol>
        <li><a href=#months><span class=secno>2.4.4.1 </span>Months</a></li>
@@ -964,34 +965,33 @@
    <li><a href=#self-contained-features><span class=secno>10.4 </span>Self-contained features</a>
     <ol>
      <li><a href=#embedded-content-1><span class=secno>10.4.1 </span>Embedded content</a></li>
-     <li><a href=#fragment-identifiers><span class=secno>10.4.2 </span>Fragment identifiers</a></li>
-     <li><a href=#frames><span class=secno>10.4.3 </span>Frames</a></li>
-     <li><a href=#ruby-annotations><span class=secno>10.4.4 </span>Ruby annotations</a></li>
-     <li><a href=#toolbars-0><span class=secno>10.4.5 </span>Toolbars</a>
+     <li><a href=#frames><span class=secno>10.4.2 </span>Frames</a></li>
+     <li><a href=#ruby-annotations><span class=secno>10.4.3 </span>Ruby annotations</a></li>
+     <li><a href=#toolbars-0><span class=secno>10.4.4 </span>Toolbars</a>
       <ol>
-       <li><a href=#the-icon-property><span class=secno>10.4.5.1 </span>The 'icon' property</a></ol></li>
-     <li><a href=#the-bb-element-0><span class=secno>10.4.6 </span>The <code>bb</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=#the-button-element-0><span class=secno>10.4.8 </span>The <code>button</code> element</a></li>
-     <li><a href=#the-datagrid-element><span class=secno>10.4.9 </span>The <code>datagrid</code> element</a></li>
-     <li><a href=#the-details-element-0><span class=secno>10.4.10 </span>The <code>details</code> element</a></li>
-     <li><a href=#the-fieldset-element-0><span class=secno>10.4.11 </span>The <code>fieldset</code> element</a></li>
-     <li><a href=#the-figure-element-0><span class=secno>10.4.12 </span>The <code>figure</code> element</a></li>
-     <li><a href=#the-hr-element-0><span class=secno>10.4.13 </span>The <code>hr</code> element</a></li>
-     <li><a href=#the-input-element-as-a-text-entry-widget><span class=secno>10.4.14 </span>The <code>input</code> element as a text entry widget</a></li>
-     <li><a href=#the-input-element-as-domain-specific-widgets><span class=secno>10.4.15 </span>The <code>input</code> element as domain-specific widgets</a></li>
-     <li><a href=#the-input-element-as-a-range-control><span class=secno>10.4.16 </span>The <code>input</code> element as a range control</a></li>
-     <li><a href=#the-input-element-as-a-color-well><span class=secno>10.4.17 </span>The <code>input</code> element as a color well</a></li>
-     <li><a href=#the-input-element-as-a-check-box-widget><span class=secno>10.4.18 </span>The <code>input</code> element as a check box widget</a></li>
-     <li><a href=#the-input-element-as-a-radio-button-widget><span class=secno>10.4.19 </span>The <code>input</code> element as a radio button widget</a></li>
-     <li><a href=#the-input-element-as-a-file-upload-control><span class=secno>10.4.20 </span>The <code>input</code> element as a file upload control</a></li>
-     <li><a href=#the-input-element-as-a-button><span class=secno>10.4.21 </span>The <code>input</code> element as a button</a></li>
-     <li><a href=#the-marquee-element><span class=secno>10.4.22 </span>The <code>marquee</code> element</a></li>
-     <li><a href=#the-meter-element-0><span class=secno>10.4.23 </span>The <code>meter</code> element</a></li>
-     <li><a href=#the-progress-element-0><span class=secno>10.4.24 </span>The <code>progress</code> element</a></li>
-     <li><a href=#the-select-element-0><span class=secno>10.4.25 </span>The <code>select</code> element</a></li>
-     <li><a href=#the-textarea-element-0><span class=secno>10.4.26 </span>The <code>textarea</code> element</a></li>
-     <li><a href=#the-title-attribute-0><span class=secno>10.4.27 </span>The <code title=attr-title>title</code> attribute</a></ol></li>
+       <li><a href=#the-icon-property><span class=secno>10.4.4.1 </span>The 'icon' property</a></ol></li>
+     <li><a href=#the-bb-element-0><span class=secno>10.4.5 </span>The <code>bb</code> element</a></li>
+     <li><a href=#the-br-element-0><span class=secno>10.4.6 </span>The <code>br</code> element</a></li>
+     <li><a href=#the-button-element-0><span class=secno>10.4.7 </span>The <code>button</code> element</a></li>
+     <li><a href=#the-datagrid-element><span class=secno>10.4.8 </span>The <code>datagrid</code> element</a></li>
+     <li><a href=#the-details-element-0><span class=secno>10.4.9 </span>The <code>details</code> element</a></li>
+     <li><a href=#the-fieldset-element-0><span class=secno>10.4.10 </span>The <code>fieldset</code> element</a></li>
+     <li><a href=#the-figure-element-0><span class=secno>10.4.11 </span>The <code>figure</code> element</a></li>
+     <li><a href=#the-hr-element-0><span class=secno>10.4.12 </span>The <code>hr</code> element</a></li>
+     <li><a href=#the-input-element-as-a-text-entry-widget><span class=secno>10.4.13 </span>The <code>input</code> element as a text entry widget</a></li>
+     <li><a href=#the-input-element-as-domain-specific-widgets><span class=secno>10.4.14 </span>The <code>input</code> element as domain-specific widgets</a></li>
+     <li><a href=#the-input-element-as-a-range-control><span class=secno>10.4.15 </span>The <code>input</code> element as a range control</a></li>
+     <li><a href=#the-input-element-as-a-color-well><span class=secno>10.4.16 </span>The <code>input</code> element as a color well</a></li>
+     <li><a href=#the-input-element-as-a-check-box-widget><span class=secno>10.4.17 </span>The <code>input</code> element as a check box widget</a></li>
+     <li><a href=#the-input-element-as-a-radio-button-widget><span class=secno>10.4.18 </span>The <code>input</code> element as a radio button widget</a></li>
+     <li><a href=#the-input-element-as-a-file-upload-control><span class=secno>10.4.19 </span>The <code>input</code> element as a file upload control</a></li>
+     <li><a href=#the-input-element-as-a-button><span class=secno>10.4.20 </span>The <code>input</code> element as a button</a></li>
+     <li><a href=#the-marquee-element><span class=secno>10.4.21 </span>The <code>marquee</code> element</a></li>
+     <li><a href=#the-meter-element-0><span class=secno>10.4.22 </span>The <code>meter</code> element</a></li>
+     <li><a href=#the-progress-element-0><span class=secno>10.4.23 </span>The <code>progress</code> element</a></li>
+     <li><a href=#the-select-element-0><span class=secno>10.4.24 </span>The <code>select</code> element</a></li>
+     <li><a href=#the-textarea-element-0><span class=secno>10.4.25 </span>The <code>textarea</code> element</a></li>
+     <li><a href=#the-title-attribute-0><span class=secno>10.4.26 </span>The <code title=attr-title>title</code> attribute</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></li>
@@ -2465,6 +2465,101 @@
    <li><p>Return the <var title="">numbers</var> list and
    abort.</li>
 
+  </ol><h5 id=lists-of-dimensions><span class=secno>2.4.3.7 </span>Lists of dimensions</h5><!-- no definition of a type since no conforming feature uses this
+  syntax (it's only used in cols="" and rows="" on <frameset> --><p>The <dfn id=rules-for-parsing-a-list-of-dimensions>rules for parsing a list of dimensions</dfn> are as
+  follows. These rules return a list of zero or more pairs consisting
+  of a number and a unit, the unit being one of <i>percentage</i>,
+  <i>relative</i>, and <i>absolute</i>.<ol><li><p>Let <var title="">raw input</var> be the string being
+   parsed.</li>
+
+   <li><p>If the last character in <var title="">raw input</var> is a
+   U+002C COMMA character (","), then remove that character from <var title="">raw input</var>.</li>
+
+   <li><p><a href=#split-a-string-on-commas title="split a string on commas">Split the string <var title="">raw input</var> on commas</a>. Let <var title="">raw
+   tokens</var> be the resulting list of tokens.</li>
+
+   <li><p>Let <var title="">result</var> be an empty list of
+   number/unit pairs.</li>
+
+   <li>
+
+    <p>For each token in <var title="">raw tokens</var>, run the
+    following substeps:</p>
+
+    <ol><li><p>Let <var title="">input</var> be the token.</li>
+
+     <li><p>Let <var title="">position</var> be a pointer into <var title="">input</var>, initially pointing at the start of the
+     string.</li>
+
+     <li><p>Let <var title="">value</var> be the number 0.</li>
+
+     <li><p>Let <var title="">unit</var> be <i>absolute</i>.</li>
+
+     <li><p>If <var title="">position</var> is past the end of <var title="">input</var>, set <var title="">unit</var> to
+     <i>relative</i> and jump to the last substep.</li>
+
+     <li><p>If the character at <var title="">position</var> is a
+     character in the range U+0030 DIGIT ZERO (0) to U+0039 DIGIT NINE
+     (9), <a href=#collect-a-sequence-of-characters>collect a sequence of characters</a> in the range
+     U+0030 DIGIT ZERO (0) to U+0039 DIGIT NINE (9), interpret the
+     resulting sequence as an integer in base ten, and increment <var title="">value</var> by that integer.</li>
+
+     <li>
+
+      <p>If the character at <var title="">position</var> is a U+002E
+      FULL STOP character (.), run these substeps:</p>
+
+      <ol><li><p><a href=#collect-a-sequence-of-characters>Collect a sequence of characters</a> consisting
+       of <a href=#space-character title="space character">space characters</a> and
+       characters in the range U+0030 DIGIT ZERO (0) to U+0039 DIGIT
+       NINE (9). Let <var title="">s</var> be the resulting
+       sequence.</li>
+
+       <li><p>Remove all <a href=#space-character title="space character">space
+       characters</a> in <var title="">s</var>.</li>
+
+       <li>
+
+        <p>If <var title="">s</var> is not the empty string, run these
+        subsubsteps:</p>
+
+        <ol><li><p>Let <var title="">length</var> be the number of
+         characters in <var title="">s</var> (after the spaces were
+         removed).</li>
+
+         <li><p>Let <var title="">fraction</var> be the result of
+         interpreting <var title="">s</var> as a base-ten integer, and
+         then dividing that number by <span title="">10<sup title=""><var title="">length</var></sup></span>.</li>
+
+         <li><p>Increment <var title="">value</var> by <var title="">fraction</var>.</li>
+
+        </ol></li>
+
+      </ol></li>
+
+     <li><p><a href=#skip-whitespace>Skip whitespace</a>.</li>
+
+     <li>
+
+      <p>If the character at <var title="">position</var> is a U+0025
+      PERCENT SIGN (%) character, then set <var title="">unit</var> to
+      <i>percentage</i>.</p>
+
+      <p>Otherwise, if the character at <var title="">position</var>
+      is a U+002A ASTERISK character (*), then set <var title="">unit</var> to <i>relative</i>.</p>
+
+     </li>
+
+     <!-- the remaining characters in /input/ are ignored -->
+
+     <li><p>Add an entry to <var title="">result</var> consisting of
+     the number given by <var title="">value</var> and the unit given
+     by <var title="">unit</var>.</li>
+
+    </ol></li>
+
+   <li><p>Return the list <var title="">result</var>.</li>
+
   </ol><h4 id=dates-and-times><span class=secno>2.4.4 </span>Dates and times</h4><p>In the algorithms below, the <dfn id=number-of-days-in-month-month-of-year-year>number of days in month <var title="">month</var> of year <var title="">year</var></dfn> is:
   <em>31</em> if <var title="">month</var> is 1, 3, 5, 7, 8, 10, or
   12; <em>30</em> if <var title="">month</var> is 4, 6, 9, or 11;
@@ -3256,12 +3351,17 @@
   </ol><p class=note>This causes any occurrences of the token to be
   removed from the string, and any spaces that were surrounding the
   token to be collapsed to a single space, except at the start and end
-  of the string, where such spaces are removed.<h4 id=comma-separated-tokens><span class=secno>2.4.7 </span>Comma-separated tokens</h4><p class=XXX>We should allow whitespace around commas, and
-  leading/trailing whitespace.<p>A <dfn id=set-of-comma-separated-tokens>set of comma-separated tokens</dfn> is a set of zero or
+  of the string, where such spaces are removed.<h4 id=comma-separated-tokens><span class=secno>2.4.7 </span>Comma-separated tokens</h4><p>A <dfn id=set-of-comma-separated-tokens>set of comma-separated tokens</dfn> is a set of zero or
   more tokens each separated from the next by a single U+002C COMMA
   character (<code title="">,</code>), where tokens consist of any
-  string of zero or more characters, none of which are U+002C COMMA
-  characters (<code title="">,</code>).<p><a href=#set-of-comma-separated-tokens title="set of comma-separated tokens">Sets of
+  string of zero or more characters, neither beginning nor ending with
+  <a href=#space-character title="space character">space characters</a>, nor
+  containing any U+002C COMMA characters (<code title="">,</code>),
+  and optionally surrounded by <a href=#space-character title="space character">space
+  characters</a>.<p class=example>For instance, the string "<code title="">&nbsp;a&nbsp;,b,,d&nbsp;d&nbsp;</code>" consists of four
+  tokens: "a", "b", the empty string, and "d&nbsp;d". Leading and
+  trailing whitespace around each token doesn't count as part of the
+  token, and the empty string can be a token.<p><a href=#set-of-comma-separated-tokens title="set of comma-separated tokens">Sets of
   comma-separated tokens</a> sometimes have further restrictions on
   what consists a valid token. When such restrictions are defined, the
   tokens must all fit within those restrictions; other values are
@@ -3280,10 +3380,12 @@
    end of <var title="">input</var>, jump to the last step.</li>
 
    <li><p><a href=#collect-a-sequence-of-characters>Collect a sequence of characters</a> that are not
-   U+002C COMMA characters (<code title="">,</code>).</li>
+   U+002C COMMA characters (<code title="">,</code>). Let <var title="">s</var> be the resulting sequence (which might be the
+   empty string).</li>
 
-   <li><p>Add the string collected in the previous step (which might
-   be the empty string) to <var title="">tokens</var>.</li>
+   <li><p>Remove any leading or trailing sequence of <a href=#space-character title="space character">space characters</a> from <var title="">s</var>.</li>
+
+   <li><p>Add <var title="">s</var> to <var title="">tokens</var>.</li>
 
    <li><p>If <var title="">position</var> is not past the end of <var title="">input</var>, then the character at <var title="">position</var> is a U+002C COMMA character (<code title="">,</code>); advance <var title="">position</var> past that
    character.</li>
@@ -21094,9 +21196,9 @@
   single <a href=#valid-e-mail-address>valid e-mail address</a>, the element is
   <a href=#suffering-from-a-type-mismatch>suffering from a type mismatch</a>.<p>A <dfn id=valid-e-mail-address-list>valid e-mail address list</dfn> is a <a href=#set-of-comma-separated-tokens>set of
   comma-separated tokens</a>, where each token is itself a
-  <a href=#valid-e-mail-address>valid e-mail address</a>, possibly with one or more leading
-  or trailing <a href=#space-character title="space character">space
-  characters</a>.<p>A <dfn id=valid-e-mail-address>valid e-mail address</dfn> is a string that matches the
+  <a href=#valid-e-mail-address>valid e-mail address</a>. To obtain the list of tokens from
+  a <a href=#valid-e-mail-address-list>valid e-mail address list</a>, the user agent must <a href=#split-a-string-on-commas title="split a string on commas">split the string on
+  commas</a>.<p>A <dfn id=valid-e-mail-address>valid e-mail address</dfn> is a string that matches the
   production <code title="">dot-atom&nbsp;"@"&nbsp;dot-atom</code>
   where <code title="">dot-atom</code> is defined in RFC 2822 section
   3.2.4, excluding the <code>CFWS</code> production everywhere. <a href=#references>[RFC2822]</a><div class=bookkeeping>
@@ -22233,7 +22335,9 @@
 
   </dl><p>The tokens must not be <a href=#ascii-case-insensitive>ASCII case-insensitive</a>
   matches for any of the other tokens (i.e. duplicates are not
-  allowed).<p>User agents should prevent the user from selecting files that are
+  allowed). To obtain the list of tokens from the attribute, the user
+  agent must <a href=#split-a-string-on-commas title="split a string on commas">split the
+  attribute value on commas</a>.<p>User agents should prevent the user from selecting files that are
   not accepted by one (or more) of these tokens.</p><hr><div class=bookkeeping>
 
    <p>The following common <code><a href=#the-input-element>input</a></code> element content
@@ -46226,7 +46330,36 @@
   <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>The <code><a href=#the-table-element>table</a></code> element's <code title=attr-table-cellspacing>cellspacing</code> attribute
+  is no <a href=#container-frame-element>container frame element</a>.</p><hr><p>If the <code>Document</code> has a <a href=#root-element>root element</a>, and
+  the <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, and that element
+  has a <code title=attr-frames-scrolling>scrolling</code>
+  attribute, then the user agent is expected to compare the value of
+  the attribute in an <a href=#ascii-case-insensitive>ASCII case-insensitive</a> manner to
+  the values in the first column of the following table, and if one of
+  them matches, then the user agent is expected to treat that
+  attribute as a <a href=#presentational-hints title="presentational hints">presentational
+  hint</a> for the aforementioned root element's 'overflow'
+  property, setting it to the value given in the corresponding cell on
+  the same row in the second column:<table><thead><tr><th> Attribute value
+     <th> 'overflow' value
+   <tbody><tr><td><code title="">on</code>
+     <td>'scroll'
+    <tr><td><code title="">scroll</code>
+     <td>'scroll'
+    <tr><td><code title="">yes</code>
+     <td>'scroll'
+    <tr><td><code title="">off</code>
+     <td>'hidden'
+    <tr><td><code title="">noscroll</code>
+     <td>'hidden'
+    <tr><td><code title="">no</code>
+     <td>'hidden'
+    <tr><td><code title="">auto</code>
+     <td>'auto'
+  </table><hr><p>The <code><a href=#the-table-element>table</a></code> element's <code title=attr-table-cellspacing>cellspacing</code> attribute
   <a href=#maps-to-the-pixel-length-property>maps to the pixel length property</a> 'border-spacing' on the
   element.<p>The <code><a href=#the-table-element>table</a></code> element's <code title=attr-table-cellpadding>cellpadding</code> attribute <a href=#maps-to-the-pixel-length-property title="maps to the pixel length property">maps to the pixel length
   properties</a> 'padding-top', 'padding-right', 'padding-bottom',
@@ -46911,11 +47044,275 @@
   <code>Document</code> is in <a href=#quirks-mode>quirks mode</a>:<pre class=css>@namespace url(http://www.w3.org/1999/xhtml);
 
 img[align=left] { margin-right: 3px; }
-img[align=right] { margin-left: 3px; }</pre><h4 id=fragment-identifiers><span class=secno>10.4.2 </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?  --><h4 id=frames><span class=secno>10.4.3 </span>Frames</h4><p class=XXX>...</p><!-- <frame>: bordercolor; frameborder (yes/1|no/0); marginwidth, marginheight (int/%); scrolling (yes/on/scroll|no/off/noscroll|auto) --><!-- <frame>, <iframe>: scrolling (yes/on/scroll|no/off/noscroll|auto) --><h4 id=ruby-annotations><span class=secno>10.4.4 </span>Ruby annotations</h4><p class=XXX>...</p><!-- XXX ruby, rt, rp 
+img[align=right] { margin-left: 3px; }</pre><h4 id=frames><span class=secno>10.4.2 </span>Frames</h4><p>When an <code><a href=#the-html-element>html</a></code> element's second child element is a
+  <code>frameset</code> element, the user agent is expected to render
+  the <code>frameset</code> element as described below across the
+  surface of the <a href=#view>view</a>, instead of applying the usual CSS
+  rendering rules.<p>When rendering a <code>frameset</code> on a surface, the user
+  agent is expected to use the following layout algorithm:<ol><li>
+
+    <p>The <var title="">cols</var> and <var title="">rows</var>
+    variables are lists of zero or more pairs consisting of a number
+    and a unit, the unit being one of <i>percentage</i>,
+    <i>relative</i>, and <i>absolute</i>.</p>
+
+    <p>Use the <a href=#rules-for-parsing-a-list-of-dimensions>rules for parsing a list of dimensions</a> to
+    parse the value of the element's <code title=attr-frameset-cols>cols</code> attribute, if there is
+    one. Let <var title="">cols</var> be the result, or an empty list
+    if there is no such attribute.</p>
+
+    <p>Use the <a href=#rules-for-parsing-a-list-of-dimensions>rules for parsing a list of dimensions</a> to
+    parse the value of the element's <code title=attr-frameset-rows>rows</code> attribute, if there is
+    one. Let <var title="">rows</var> be the result, or an empty list
+    if there is no such attribute.</p>
+
+   </li>
+
+   <li>
+
+    <p>For any of the entries in <var title="">cols</var> or <var title="">rows</var> that have the number zero and the unit
+    <i>relative</i>, change the entry's number to one.</p>
+
+   </li>
+
+   <li>
+
+    <p>If <var title="">cols</var> has no entries, then add a single
+    entry consisting of the value 1 and the unit <i>relative</i> to
+    <var title="">cols</var>.</p>
+
+    <p>If <var title="">rows</var> has no entries, then add a single
+    entry consisting of the value 1 and the unit <i>relative</i> to
+    <var title="">rows</var>.</p>
+
+   </li>
+
+   <li>
+
+    <p>Invoke the algorithm defined below to <a href=#convert-a-list-of-dimensions-to-a-list-of-pixel-values>convert a list of
+    dimensions to a list of pixel values</a> using <var title="">cols</var> as the input list, and the width of the
+    surface that the <code><a href=#the-fieldset-element>fieldset</a></code> is being rendered into, in
+    CSS pixels, as the input dimension. Let <var title="">sized
+    cols</var> be the resulting list.</p>
+
+    <p>Invoke the algorithm defined below to <a href=#convert-a-list-of-dimensions-to-a-list-of-pixel-values>convert a list of
+    dimensions to a list of pixel values</a> using <var title="">rows</var> as the input list, and the height of the
+    surface that the <code><a href=#the-fieldset-element>fieldset</a></code> is being rendered into, in
+    CSS pixels, as the input dimension. Let <var title="">sized
+    rows</var> be the resulting list.</p>
+
+   </li>
+
+   <li>
+
+    <p>Split the surface into a grid of <span title=""><var title="">w</var>&times;<var title="">h</var></span> rectangles,
+    where <var title="">w</var> is the number of entries in <var title="">sized cols</var> and <var title="">h</var> is the number
+    of entries in <var title="">sized rows</var>.</p>
+
+    <p>Size the columns so that each column in the grid is as many CSS
+    pixels wide as the corresponding entry in the <var title="">sized
+    cols</var> list.</p>
+
+    <p>Size the rows so that each row in the grid is as many CSS
+    pixels high as the corresponding entry in the <var title="">sized
+    rows</var> list.</p>
+
+   </li>
+
+   <li>
+
+    <p>Let <var title="">children</var> be the list of
+    <code>frame</code> and <code>frameset</code> elements that are
+    children of the <code>frameset</code> element for which the
+    algorithm was invoked.</p>
+
+   </li>
+
+   <li>
+
+    <p>For each row of the grid of rectangles created in the previous
+    step, from top to bottom, run these substeps:</p>
+
+    <ol><li>
+
+      <p>For each rectangle in the row, from left to right, run these
+      substeps:</p>
+
+      <ol><li>
+
+        <p>If there are any elements left in <var title="">children</var>, take the first element in the list,
+        and assign it to the rectangle.</p>
+
+        <p>If this is a <code>frameset</code> element, then recurse
+        the entire <code>frameset</code> layout algorithm for that
+        <code>frameset</code> element, with the rectangle as the
+        surface.</p>
+
+        <p>Otherwise, it is a <code>frame</code> element; create a
+        <a href=#nested-browsing-context>nested browsing context</a> sized to fit the
+        rectangle.</p>
+
+       </li>
+
+       <li>
+
+        <p>If there are any elements left in <var title="">children</var>, remove the first element from <var title="">children</var>.</p>
+
+      </ol></li>
+
+    </ol></li>
+
+   <li>
+
+    <p>If the <code>frameset</code> element <a href=#has-a-border>has a border</a>,
+    draw an outer set of borders around the rectangles, using the
+    element's <a href=#frame-border-color>frame border color</a>.</p>
+
+    <p>For each rectangle, if there is an element assigned to that
+    rectangle, and that element <a href=#has-a-border>has a border</a>, draw an
+    inner set of borders around that rectangle, using the
+    element's <a href=#frame-border-color>frame border color</a>.</p>
+
+    <p>For each (visible) border that does not abut a rectangle that
+    is assigned a <code>frame</code> element with a <code title=attr-frame-noresize>noresize</code> attribute (including
+    rectangles in further nested <code>frameset</code> elements), the
+    user agent is expected to allow the user to move the border,
+    resizing the rectangles within, keeping the proportions of any
+    nested <code>frameset</code> grids.</p>
+
+    <p>A <code>frameset</code> or <code>frame</code> element <dfn id=has-a-border>has
+    a border</dfn> if the following algorithm returns true:</p>
+
+    <ol><li><p>If the element has a <code title=attr-frames-frameborder>frameborder</code> attribute
+     whose value is not the empty string and whose first character is
+     either a U+0031 DIGIT ONE (1), a U+0079 LATIN SMALL LETTER Y, or
+     a U+0059 LATIN CAPITAL LETTER Y, then return true.</li>
+
+     <li><p>Otherwise, if the element has a <code title=attr-frames-frameborder>frameborder</code> attribute,
+     return false.</li>
+
+     <li><p>Otherwise, if the element has a parent element that is a
+     <code>frameset</code> element, then return true if <em>that</em>
+     element <a href=#has-a-border>has a border</a>, and false if it does
+     not.</li>
+
+     <li><p>Otherwise, return true.</li>
+
+    </ol><p>The <dfn id=frame-border-color>frame border color</dfn> of a <code>frameset</code> or
+    <code>frame</code> element is the color obtained from the
+    following algorithm:</p>
+
+    <ol><li><p>If the element has a <code title=attr-frames-bordercolor>bordercolor</code> attribute,
+     then return the color obtained from applying the <a href=#rules-for-parsing-a-legacy-color-value>rules for
+     parsing a legacy color value</a> to that attribute's
+     value.</li>
+
+     <li><p>Otherwise, if the element has a parent element that is a
+     <code>frameset</code> element, then the <a href=#frame-border-color>frame border
+     color</a> of that element.</p>
+
+     <li><p>Otherwise, return gray.</li>
+
+    </ol></li>
+
+  </ol><p>The algorithm to <dfn id=convert-a-list-of-dimensions-to-a-list-of-pixel-values>convert a list of dimensions to a list of
+  pixel values</dfn> consists of the following steps:<ol><li>
+
+    <p>Let <var title="">input list</var> be the list of numbers and
+    units passed to the algorithm.</p>
+
+    <p>Let <var title="">output list</var> be a list of numbers the
+    same length as <var title="">input list</var>, all zero.</p>
+
+    <p>Entries in <var title="">output list</var> correspond to the
+    entries in <var title="">input list</var> that have the same
+    position.</p>
+
+   </li>
+
+   <li><p>Let <var title="">input dimension</var> be the size passed
+   to the algorithm.</p>
+
+   <li>
+
+    <p>Let <var title="">count percentage</var> be the number of
+    entries in <var title="">input list</var> whose unit is
+    <i>percentage</i>.</p>
+
+    <p>Let <var title="">total percentage</var> be the sum of all the
+    numbers in <var title="">input list</var> whose unit is
+    <i>percentage</i>.</p>
+
+    <p>Let <var title="">count relative</var> be the number of
+    entries in <var title="">input list</var> whose unit is
+    <i>relative</i>.</p>
+
+    <p>Let <var title="">total relative</var> be the sum of all the
+    numbers in <var title="">input list</var> whose unit is
+    <i>relative</i>.</p>
+
+    <p>Let <var title="">count absolute</var> be the number of
+    entries in <var title="">input list</var> whose unit is
+    <i>absolute</i>.</p>
+
+    <p>Let <var title="">total absolute</var> be the sum of all the
+    numbers in <var title="">input list</var> whose unit is
+    <i>absolute</i>.</p>
+
+    <p>Let <var title="">remaining space</var> be the value of <var title="">input dimension</var>.</p>
+
+   </li>
+
+   <li>
+
+    <p>If <var title="">total absolute</var> is greater than <var title="">remaining space</var>, then for each entry in <var title="">input list</var> whose unit is <i>absolute</i>, set the
+    corresponding value in <var title="">output list</var> to the
+    number of the entry in <var title="">input list</var> multiplied
+    by <var title="">remaining space</var> and divided by <var title="">total absolute</var>. Then, set <var title="">remaining
+    space</var> to zero.</p>
+
+    <p>Otherwise, for each entry in <var title="">input list</var>
+    whose unit is <i>absolute</i>, set the corresponding value in <var title="">output list</var> to the number of the entry in <var title="">input list</var>. Then, decrement <var title="">remaining
+    space</var> by <var title="">total absolute</var>.</p>
+
+   </li>
+
+   <li>
+
+    <p>If <var title="">total percentage</var> multiplied by the <var title="">input dimension</var> and divided by 100 is greater than
+    <var title="">remaining space</var>, then for each entry in <var title="">input list</var> whose unit is <i>percentage</i>, set the
+    corresponding value in <var title="">output list</var> to the
+    number of the entry in <var title="">input list</var> multiplied
+    by <var title="">remaining space</var> and divided by <var title="">total percentage</var>. Then, set <var title="">remaining
+    space</var> to zero.</p>
+
+    <p>Otherwise, for each entry in <var title="">input list</var>
+    whose unit is <i>percentage</i>, set the corresponding value in
+    <var title="">output list</var> to the number of the entry in <var title="">input list</var> multiplied by the <var title="">input
+    dimension</var> and divided by 100. Then, decrement <var title="">remaining space</var> by <var title="">total
+    percentage</var> multiplied by the <var title="">input
+    dimension</var> and divided by 100.</p>
+
+   </li>
+
+   <li>
+
+    <p>For each entry in <var title="">input list</var> whose unit is
+    <i>relative</i>, set the corresponding value in <var title="">output list</var> to the number of the entry in <var title="">input list</var> multiplied by <var title="">remaining
+    space</var> and divided by <var title="">total relative</var>.</p>
+
+   </li>
+
+   <li><p>Return <var title="">output list</var>.</li>
+
+  </ol><p>User agents working with integer values for frame widths (as
+  opposed to user agents that can lay frames out with subpixel
+  accuracy) are expected to distribute the remainder first the last
+  entry whose unit is <i>relative</i>, then equally (not
+  proportionally) to each entry whose unit is <i>percentage</i>, then
+  equally (not proportionally) to each entry whose unit is
+  <i>absolute</i>, and finally, failing all else, to the last
+  entry.<h4 id=ruby-annotations><span class=secno>10.4.3 </span>Ruby annotations</h4><p class=XXX>...</p><!-- XXX ruby, rt, rp 
   > * note on rt rendering
   > 
   > Since there are a number of documents with ruby but without rp, when you
@@ -46924,23 +47321,23 @@
   > "(" 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.
-  --><h4 id=toolbars-0><span class=secno>10.4.5 </span>Toolbars</h4><h5 id=the-icon-property><span class=secno>10.4.5.1 </span>The 'icon' property</h5><p>UAs should use the command's Icon as the default generic icon
+  --><h4 id=toolbars-0><span class=secno>10.4.4 </span>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-bb-element-0><span class=secno>10.4.6 </span>The <code><a href=#the-bb-element>bb</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>...</p><!-- clear="left|right|all|both" --><h4 id=the-button-element-0><span class=secno>10.4.8 </span>The <code><a href=#the-button-element>button</a></code> element</h4><p class=XXX>...<h4 id=the-datagrid-element><span class=secno>10.4.9 </span>The <code><a href=#datagrid>datagrid</a></code> element</h4><p class=XXX>This section will probably include details on
+  that image instead.<h4 id=the-bb-element-0><span class=secno>10.4.5 </span>The <code><a href=#the-bb-element>bb</a></code> element</h4><p class=XXX>...<h4 id=the-br-element-0><span class=secno>10.4.6 </span>The <code><a href=#the-br-element>br</a></code> element</h4><p class=XXX>...</p><!-- clear="left|right|all|both" --><h4 id=the-button-element-0><span class=secno>10.4.7 </span>The <code><a href=#the-button-element>button</a></code> element</h4><p class=XXX>...<h4 id=the-datagrid-element><span class=secno>10.4.8 </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=the-details-element-0><span class=secno>10.4.10 </span>The <code><a href=#the-details-element>details</a></code> element</h4><p class=XXX>...<h4 id=the-fieldset-element-0><span class=secno>10.4.11 </span>The <code><a href=#the-fieldset-element>fieldset</a></code> element</h4><p class=XXX>...</p><!-- XXX <legend align="left|right|center|bottom|top"> --><h4 id=the-figure-element-0><span class=secno>10.4.12 </span>The <code><a href=#the-figure-element>figure</a></code> element</h4><p class=XXX>...<h4 id=the-hr-element-0><span class=secno>10.4.13 </span>The <code><a href=#the-hr-element>hr</a></code> element</h4><p class=XXX>...</p><!-- align=left|right|center (as auto margins), width=(int=>width:px; %->width:%)
+  concert with CSS.<h4 id=the-details-element-0><span class=secno>10.4.9 </span>The <code><a href=#the-details-element>details</a></code> element</h4><p class=XXX>...<h4 id=the-fieldset-element-0><span class=secno>10.4.10 </span>The <code><a href=#the-fieldset-element>fieldset</a></code> element</h4><p class=XXX>...</p><!-- XXX <legend align="left|right|center|bottom|top"> --><h4 id=the-figure-element-0><span class=secno>10.4.11 </span>The <code><a href=#the-figure-element>figure</a></code> element</h4><p class=XXX>...<h4 id=the-hr-element-0><span class=secno>10.4.12 </span>The <code><a href=#the-hr-element>hr</a></code> element</h4><p class=XXX>...</p><!-- align=left|right|center (as auto margins), width=(int=>width:px; %->width:%)
        color (color implies noshade); sets 'color' which then propagates to border-color; defaults to 'gray'
        size=int, noshade
          with noshade: border-width = size/2 (default size=2 => 1px per side); solid borders; rounded corners
          without no shade: inset borders
           without noshade, size>1: height = size-2; border-width=1px
           without noshade, size=1: height = 0; border-top-width=1px only
-    --><h4 id=the-input-element-as-a-text-entry-widget><span class=secno>10.4.14 </span>The <code><a href=#the-input-element>input</a></code> element as a text entry widget</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#text-state-and-search-state title=attr-input-type-text>Text</a>, <a href=#text-state-and-search-state title=attr-input-type-search>Search</a>, <a href=#url-state title=attr-input-type-url>URL</a>, <a href=#e-mail-state title=attr-input-type-email>E-mail</a>, or <a href=#password-state title=attr-input-type-password>Password</a> state, ...</p><!-- datalist presentation --><!-- size: http://mxr.mozilla.org/mozilla-central/ident?i=CalcIntrinsicSize --><h4 id=the-input-element-as-domain-specific-widgets><span class=secno>10.4.15 </span>The <code><a href=#the-input-element>input</a></code> element as domain-specific widgets</h4><p class=XXX>When an <code><a href#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#date-and-time-state title=attr-input-type-datetime>Date and Time</a>, <a href=#date-state title=attr-input-type-date>Date</a>, <a href=#month-state title=attr-input-type-month>Month</a>, <a href=#week-state title=attr-input-type-week>Week</a>, <a href=#time-state title=attr-input-type-time>Time</a>, <a href=#local-date-and-time-state title=attr-input-type-datetime-local>Local Date and Time</a> or
-  <a href=#number-state title=attr-input-type-number>Number</a> state...</p><!-- datalist presentation --><h4 id=the-input-element-as-a-range-control><span class=secno>10.4.16 </span>The <code><a href=#the-input-element>input</a></code> element as a range control</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#range-state title=attr-input-type-range>Range</a> state, ...</p><!-- datalist presentation --><h4 id=the-input-element-as-a-color-well><span class=secno>10.4.17 </span>The <code><a href=#the-input-element>input</a></code> element as a color well</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#color-state title=attr-input-type-color>Color</a> state, ...</p><!-- datalist presentation --><h4 id=the-input-element-as-a-check-box-widget><spa class=secno>10.4.18 </span>The <code><a href=#the-input-element>input</a></code> element as a check box widget</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#checkbox-state title=attr-input-type-checkbox>Checkbox</a> state, ...<h4 id=the-input-element-as-a-radio-button-widget><span class=secno>10.4.19 </span>The <code><a href=#the-input-element>input</a></code> element as a radio button widget</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#radio-button-state title=attr-input-type-radio>Radio Button</a> state, ...<h4 id=the-input-element-as-a-file-upload-control><span class=secno>10.4.20 </span>The <code><a href=#the-input-element>input</a></code> element as a file upload control</h4><p class=XXX>When an <code><a href=#the-input-element>inpt</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#file-upload-state title=attr-input-type-file>File Upload</a> state, ...<h4 id=the-input-element-as-a-button><span class=secno>10.4.21 </span>The <code><a href=#the-input-element>input</a></code> element as a button</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#submit-button-state title=attr-input-type-submit>Submit Button</a> <a href=#reset-button-state title=attr-input-type-reset>Reset Button</a>, or <a href=#button-state title=attr-input-type-button>Button</a> state, ...<h4 id=the-marquee-element><span class=secno>10.4.22 </span>The <code><a href=#the-marquee-element-0>marquee</a></code> element</h4><p class=XXX>...</p><!-- XXX attributes: height/width; direction is case insensitive; bgcolor; hspace/vspace --><h4 id=the-meter-element-0><span class=secn>10.4.23 </span>The <code><a href=#the-meter-element>meter</a></code> element</h4><p class=XXX>...<h4 id=the-progress-element-0><span class=secno>10.4.24 </span>The <code><a href=#the-progress-element>progress</a></code> element</h4><p class=XXX>...<h4 id=the-select-element-0><span class=secno>10.4.25 </span>The <code><a href=#the-select-element>select</a></code> element</h4><p class=XXX>...</p><!-- multiple, size; optgroup --><h4 id=the-textarea-element-0><span class=secno>10.4.26 </span>The <code><a href=#the-textarea-element>textarea</a></code> element</h4><p class=XXX>...<h4 id=the-title-attribute-0><span class=secno>10.4.27 </span>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute</h4><p>Given an element (e.g. the element designated by the mouse
+    --><h4 id=the-input-element-as-a-text-entry-widget><span class=secno>10.4.13 </span>The <code><a href=#the-input-element>input</a></code> element as a text entry widget</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#text-state-and-search-state title=attr-input-type-text>Text</a>, <a href=#text-state-and-search-state title=attr-input-type-search>Search</a>, <a href=#url-state title=attr-input-type-url>URL</a>, <a href=#e-mail-state title=attr-input-type-email>E-mail</a>, or <a href=#password-state title=attr-input-type-password>Password</a> state, ...</p><!-- datalist presentation --><!-- size: http://mxr.mozilla.org/mozilla-central/ident?i=CalcIntrinsicSize --><h4 id=the-input-element-as-domain-specific-widgets><span class=secno>10.4.14 </span>The <code><a href=#the-input-element>input</a></code> element as domain-specific widgets</h4><p class=XXX>When an <code><a href#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#date-and-time-state title=attr-input-type-datetime>Date and Time</a>, <a href=#date-state title=attr-input-type-date>Date</a>, <a href=#month-state title=attr-input-type-month>Month</a>, <a href=#week-state title=attr-input-type-week>Week</a>, <a href=#time-state title=attr-input-type-time>Time</a>, <a href=#local-date-and-time-state title=attr-input-type-datetime-local>Local Date and Time</a> or
+  <a href=#number-state title=attr-input-type-number>Number</a> state...</p><!-- datalist presentation --><h4 id=the-input-element-as-a-range-control><span class=secno>10.4.15 </span>The <code><a href=#the-input-element>input</a></code> element as a range control</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#range-state title=attr-input-type-range>Range</a> state, ...</p><!-- datalist presentation --><h4 id=the-input-element-as-a-color-well><span class=secno>10.4.16 </span>The <code><a href=#the-input-element>input</a></code> element as a color well</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#color-state title=attr-input-type-color>Color</a> state, ...</p><!-- datalist presentation --><h4 id=the-input-element-as-a-check-box-widget><spa class=secno>10.4.17 </span>The <code><a href=#the-input-element>input</a></code> element as a check box widget</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#checkbox-state title=attr-input-type-checkbox>Checkbox</a> state, ...<h4 id=the-input-element-as-a-radio-button-widget><span class=secno>10.4.18 </span>The <code><a href=#the-input-element>input</a></code> element as a radio button widget</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#radio-button-state title=attr-input-type-radio>Radio Button</a> state, ...<h4 id=the-input-element-as-a-file-upload-control><span class=secno>10.4.19 </span>The <code><a href=#the-input-element>input</a></code> element as a file upload control</h4><p class=XXX>When an <code><a href=#the-input-element>inpt</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#file-upload-state title=attr-input-type-file>File Upload</a> state, ...<h4 id=the-input-element-as-a-button><span class=secno>10.4.20 </span>The <code><a href=#the-input-element>input</a></code> element as a button</h4><p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#submit-button-state title=attr-input-type-submit>Submit Button</a> <a href=#reset-button-state title=attr-input-type-reset>Reset Button</a>, or <a href=#button-state title=attr-input-type-button>Button</a> state, ...<h4 id=the-marquee-element><span class=secno>10.4.21 </span>The <code><a href=#the-marquee-element-0>marquee</a></code> element</h4><p class=XXX>...</p><!-- XXX attributes: height/width; direction is case insensitive; bgcolor; hspace/vspace --><h4 id=the-meter-element-0><span class=secn>10.4.22 </span>The <code><a href=#the-meter-element>meter</a></code> element</h4><p class=XXX>...<h4 id=the-progress-element-0><span class=secno>10.4.23 </span>The <code><a href=#the-progress-element>progress</a></code> element</h4><p class=XXX>...<h4 id=the-select-element-0><span class=secno>10.4.24 </span>The <code><a href=#the-select-element>select</a></code> element</h4><p class=XXX>...</p><!-- multiple, size; optgroup --><h4 id=the-textarea-element-0><span class=secno>10.4.25 </span>The <code><a href=#the-textarea-element>textarea</a></code> element</h4><p class=XXX>...<h4 id=the-title-attribute-0><span class=secno>10.4.26 </span>The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute</h4><p>Given an element (e.g. the element designated by the mouse
   cursor), if the element, or one of its ancestors, has a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute, and the nearest such
   attribute has a value that is not the empty string, it is expected
   that the user agent will expose the contents of that attribute as a

Received on Thursday, 5 February 2009 09:18:30 UTC