[html5] r2827 - [] (0) Clarify <small> even further, by popular request. Clarify the rules invol [...]

whatwg at whatwg.org whatwg at whatwg.org
Mon Feb 16 19:14:56 PST 2009


Author: ianh
Date: 2009-02-16 19:14:55 -0800 (Mon, 16 Feb 2009)
New Revision: 2827

Modified:
   index
   source
Log:
[] (0) Clarify <small> even further, by popular request. Clarify the rules involved in the handshake of the Web Socket protocol. Some editorial tweaks.

Modified: index
===================================================================
--- index	2009-02-14 01:26:18 UTC (rev 2826)
+++ index	2009-02-17 03:14:55 UTC (rev 2827)
@@ -34,7 +34,7 @@
   <div class=head>
    <p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
    <h1>HTML 5</h1>
-   <h2 class="no-num no-toc" id=draft-recommendation-—-date:-01-jan-1901>Draft Recommendation — 14 February 2009</h2>
+   <h2 class="no-num no-toc" id=draft-recommendation-—-date:-01-jan-1901>Draft Recommendation — 17 February 2009</h2>
    <p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
    <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
    <dl><dt>Multiple-page version:</dt>
@@ -13092,10 +13092,12 @@
    <dt>DOM interface:</dt>
    <dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
   </dl><p>The <code><a href=#the-small-element>small</a></code> element <a href=#represents>represents</a> small
-  print (part of a document often describing disclaimers, caveats, or
-  legal restrictions, such as copyrights or other disadvantages), or
-  other side comments.</p>
+  print or other side comments.</p>
 
+  <p class=note>Small print is typically legalese describing
+  disclaimers, caveats, legal restrictions, or copyrights. Small print
+  is also sometimes used for attribution.</p>
+
   <p class=note>The <code><a href=#the-small-element>small</a></code> element does not
   "de-emphasize" or lower the importance of text emphasised by the
   <code><a href=#the-em-element>em</a></code> element or marked as important with the
@@ -16837,7 +16839,9 @@
   </div>
 
 
-  <hr><p>The <dfn id=attr-iframe-seamless title=attr-iframe-seamless><code>seamless</code></dfn>
+  <hr><!-- v2: Might be interesting to have a value on seamless that
+  allowed event propagation of some sort, maybe based on the WICD
+  work: http://www.w3.org/TR/WICD/ --><p>The <dfn id=attr-iframe-seamless title=attr-iframe-seamless><code>seamless</code></dfn>
   attribute is a boolean attribute. When specified, it indicates that
   the <code><a href=#the-iframe-element>iframe</a></code> element's <a href=#browsing-context>browsing context</a> is
   to be rendered in a manner that makes it appear to be part of the
@@ -45712,14 +45716,15 @@
 
    <li><p>Let <var title="">origin</var> be the <a href=#ascii-serialization-of-an-origin title="ASCII
    serialization of an origin">ASCII serialization</a> of the
-   <a href=#origin-0>origin</a> of the script that invoked the <code title=dom-WebSocket><a href=#dom-websocket>WebSocket()</a></code> constructor.</li>
+   <a href=#origin-0>origin</a> of the script that invoked the <code title=dom-WebSocket><a href=#dom-websocket>WebSocket()</a></code> constructor,
+   <a href=#converted-to-lowercase>converted to lowercase</a>.</li>
 
    <li><p>If the <a href=#url-scheme title=url-scheme><scheme></a>
    component of <var title="">url</var> is "<code title="">ws</code>",
    set <var title="">secure</var> to false; otherwise, the <a href=#url-scheme title=url-scheme><scheme></a> component is "<code title="">wss</code>", set <var title="">secure</var> to
    true.</li>
 
-   <li><p>Let <var title="">host</var> be the value of the <a href=#url-host title=url-host><host></a> component of <var title="">url</var>.</li>
+   <li><p>Let <var title="">host</var> be the value of the <a href=#url-host title=url-host><host></a> component of <var title="">url</var>, <a href=#converted-to-lowercase>converted to lowercase</a>.</li>
 
    <li><p>If <var title="">url</var> has a <a href=#url-port title=url-port><port></a> component, then let <var title="">port</var> be that component's value; otherwise, there is
    no explicit <var title="">port</var>.</li>
@@ -45888,8 +45893,11 @@
   connection</dfn> to a host <var title="">host</var>, optionally on
   port <var title="">port</var>, from an origin <var title="">origin</var>, with a flag <var title="">secure</var>, and
   with a particular <var title="">resource name</var>, it must run the
-  following steps:</p>
+  following steps.</p>
 
+  <p class=note>The <var title="">host</var> and <var title="">origin</var> strings will be all-lowercase when this
+  algorithm is invoked.</p>
+
   <ol><li>
 
     <p>If there is no explicit <var title="">port</var>, then: if <var title="">secure</var> is false, let <var title="">port</var> be 81,
@@ -45963,9 +45971,8 @@
 
     <pre>48 6f 73 74 3a 20</pre>
 
-    <p>Send the <var title="">host</var> value, encoded as US-ASCII
-    and <a href=#converted-to-lowercase>converted to lowercase</a>, if it represents a host
-    name (and not an IP address).</p>
+    <p>Send the <var title="">host</var> value, encoded as
+    US-ASCII.</p>
 
     <p>Send the following bytes:</p>
 
@@ -45981,9 +45988,11 @@
 
     <pre>4f 72 69 67 69 6e 3a 20</pre>
 
-    <p>Send the <var title="">origin</var> value, encoded as US-ASCII
-    and <a href=#converted-to-lowercase>converted to lowercase</a>.</p>
+    <p>Send the <var title="">origin</var> value, encoded as US-ASCII.</p>
 
+    <p class=note>The <var title="">origin</var> value is a string
+    that was passed to this algorithm.</p>
+
     <p>Send the following bytes:</p>
 
     <pre>0d 0a</pre>

Modified: source
===================================================================
--- source	2009-02-14 01:26:18 UTC (rev 2826)
+++ source	2009-02-17 03:14:55 UTC (rev 2827)
@@ -13910,10 +13910,12 @@
   </dl>
 
   <p>The <code>small</code> element <span>represents</span> small
-  print (part of a document often describing disclaimers, caveats, or
-  legal restrictions, such as copyrights or other disadvantages), or
-  other side comments.</p>
+  print or other side comments.</p>
 
+  <p class="note">Small print is typically legalese describing
+  disclaimers, caveats, legal restrictions, or copyrights. Small print
+  is also sometimes used for attribution.</p>
+
   <p class="note">The <code>small</code> element does not
   "de-emphasize" or lower the importance of text emphasised by the
   <code>em</code> element or marked as important with the
@@ -17971,6 +17973,9 @@
   <hr>
 
 
+  <!-- v2: Might be interesting to have a value on seamless that
+  allowed event propagation of some sort, maybe based on the WICD
+  work: http://www.w3.org/TR/WICD/ -->
 
   <p>The <dfn title="attr-iframe-seamless"><code>seamless</code></dfn>
   attribute is a boolean attribute. When specified, it indicates that
@@ -52197,7 +52202,8 @@
    <li><p>Let <var title="">origin</var> be the <span title="ASCII
    serialization of an origin">ASCII serialization</span> of the
    <span>origin</span> of the script that invoked the <code
-   title="dom-WebSocket">WebSocket()</code> constructor.</p></li>
+   title="dom-WebSocket">WebSocket()</code> constructor,
+   <span>converted to lowercase</span>.</p></li>
 
    <li><p>If the <span title="url-scheme"><scheme></span>
    component of <var title="">url</var> is "<code title="">ws</code>",
@@ -52208,7 +52214,7 @@
 
    <li><p>Let <var title="">host</var> be the value of the <span
    title="url-host"><host></span> component of <var
-   title="">url</var>.</p></li>
+   title="">url</var>, <span>converted to lowercase</span>.</p></li>
 
    <li><p>If <var title="">url</var> has a <span
    title="url-port"><port></span> component, then let <var
@@ -52429,8 +52435,12 @@
   port <var title="">port</var>, from an origin <var
   title="">origin</var>, with a flag <var title="">secure</var>, and
   with a particular <var title="">resource name</var>, it must run the
-  following steps:</p>
+  following steps.</p>
 
+  <p class="note">The <var title="">host</var> and <var
+  title="">origin</var> strings will be all-lowercase when this
+  algorithm is invoked.</p>
+
   <ol>
 
    <li>
@@ -52510,9 +52520,8 @@
 
     <pre>48 6f 73 74 3a 20</pre>
 
-    <p>Send the <var title="">host</var> value, encoded as US-ASCII
-    and <span>converted to lowercase</span>, if it represents a host
-    name (and not an IP address).</p>
+    <p>Send the <var title="">host</var> value, encoded as
+    US-ASCII.</p>
 
     <p>Send the following bytes:</p>
 
@@ -52528,9 +52537,11 @@
 
     <pre>4f 72 69 67 69 6e 3a 20</pre>
 
-    <p>Send the <var title="">origin</var> value, encoded as US-ASCII
-    and <span>converted to lowercase</span>.</p>
+    <p>Send the <var title="">origin</var> value, encoded as US-ASCII.</p>
 
+    <p class="note">The <var title="">origin</var> value is a string
+    that was passed to this algorithm.</p>
+
     <p>Send the following bytes:</p>
 
     <pre>0d 0a</pre>




More information about the Commit-Watchers mailing list