[html5] r7808 - [e] (0) Use more WebIDL, reduce amount of prose. Also, some typo fixes. Fixing h [...]

whatwg at whatwg.org whatwg at whatwg.org
Thu Apr 11 15:00:06 PDT 2013


Author: ianh
Date: 2013-04-11 15:00:00 -0700 (Thu, 11 Apr 2013)
New Revision: 7808

Modified:
   complete.html
   index
   source
Log:
[e] (0) Use more WebIDL, reduce amount of prose. Also, some typo fixes.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=21657
Affected topics: DOM APIs, HTML, Video Text Tracks, Video and Audio

Modified: complete.html
===================================================================
--- complete.html	2013-04-11 21:42:13 UTC (rev 7807)
+++ complete.html	2013-04-11 22:00:00 UTC (rev 7808)
@@ -22623,7 +22623,7 @@
   <p class=note>This allows servers to return images with error responses, and have them
   displayed.</p>
 
-  <p>The user agents should apply the <a href=#content-type-sniffing:-image title="Content-Type sniffing: image">image sniffing
+  <p>The user agent should apply the <a href=#content-type-sniffing:-image title="Content-Type sniffing: image">image sniffing
   rules</a> to determine the type of the image, with the image's <a href=#content-type title=Content-Type>associated Content-Type headers</a> giving the <var title="">official
   type</var>. If these rules are not applied, then the type of the image must be the type given by
   the image's <a href=#content-type title=Content-Type>associated Content-Type headers</a>.</p>
@@ -24162,14 +24162,12 @@
  <figcaption>Barney Frank, 2011</figcaption>
 </figure></pre>
 
-  <p class=note>For details on what to put in the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute, see the earlier
-  sections.</p>
+  <p class=note>For details on what to put in the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute,
+  see the earlier sections.</p>
 
-  <p>The problem with this is that the user agent does not necessarily
-  know what dimensions to use for the image when the image is loading.
-  To avoid the layout having to be reflowed multiple times as the page
-  is loading, CSS and CSS media queries can be used to provide the
-  dimensions:</p>
+  <p>The problem with this is that the user agent does not necessarily know what dimensions to use
+  for the image when the image is loading. To avoid the layout having to be reflowed multiple times
+  as the page is loading, CSS and CSS media queries can be used to provide the dimensions:</p>
 
   <pre><figure>
  <style scoped>
@@ -24181,10 +24179,8 @@
  <figcaption>Barney Frank, 2011</figcaption>
 </figure></pre>
 
-  <p>Alternatively, the <code title=attr-dim-width><a href=#attr-dim-width>width</a></code> and
-  <code title=attr-dim-height><a href=#attr-dim-height>height</a></code> attributes can be used
-  to provide the width for legacy user agents, using CSS just for the
-  user agents that support <code title=attr-img-srcset><a href=#attr-img-srcset>srcset</a></code>:</p>
+  <p>Alternatively, the <code title=attr-dim-width><a href=#attr-dim-width>width</a></code> and <code title=attr-dim-height><a href=#attr-dim-height>height</a></code> attributes can be used to provide the width for legacy user
+  agents, using CSS just for the user agents that support <code title=attr-img-srcset><a href=#attr-img-srcset>srcset</a></code>:</p>
 
   <pre><figure>
  <style scoped media="all and (max-width: 600px)">
@@ -26588,7 +26584,7 @@
 
   <div class=example>
 
-   <p>If the author isn't sure if the user agents will all be able to render the media resources
+   <p>If the author isn't sure if user agents will all be able to render the media resources
    provided, the author can listen to the <code title=event-error>error</code> event on the last
    <code><a href=#the-source-element>source</a></code> element and trigger fallback behavior:</p>
 
@@ -26635,7 +26631,7 @@
    <dt><a href=#element-dfn-dom title=element-dfn-dom>DOM interface</a>:</dt><!--TOPIC:DOM APIs-->
    <dd>
 <pre class=idl>interface <dfn id=htmltrackelement>HTMLTrackElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
-           attribute DOMString <a href=#dom-track-kind title=dom-track-kind>kind</a>;
+           attribute <a href=#texttrackkind>TextTrackKind</a> <a href=#dom-track-kind title=dom-track-kind>kind</a>;
            attribute DOMString <a href=#dom-track-src title=dom-track-src>src</a>;
            attribute DOMString <a href=#dom-track-srclang title=dom-track-srclang>srclang</a>;
            attribute DOMString <a href=#dom-track-label title=dom-track-label>label</a>;
@@ -26890,7 +26886,7 @@
   readonly attribute <a href=#audiotracklist>AudioTrackList</a> <a href=#dom-media-audiotracks title=dom-media-audioTracks>audioTracks</a>;
   readonly attribute <a href=#videotracklist>VideoTrackList</a> <a href=#dom-media-videotracks title=dom-media-videoTracks>videoTracks</a>;
   readonly attribute <a href=#texttracklist>TextTrackList</a> <a href=#dom-media-texttracks title=dom-media-textTracks>textTracks</a>;
-  <a href=#texttrack>TextTrack</a> <a href=#dom-media-addtexttrack title=dom-media-addTextTrack>addTextTrack</a>(DOMString kind, optional DOMString label, optional DOMString language);
+  <a href=#texttrack>TextTrack</a> <a href=#dom-media-addtexttrack title=dom-media-addTextTrack>addTextTrack</a>(<a href=#texttrackkind>TextTrackKind</a> kind, optional DOMString label = '', optional DOMString language = '');
 };</pre>
 
   <p>The <dfn id=media-element-attributes>media element attributes</dfn>, <code title=attr-media-src><a href=#attr-media-src>src</a></code>, <code title=attr-media-crossorigin><a href=#attr-media-crossorigin>crossorigin</a></code>, <code title=attr-media-preload><a href=#attr-media-preload>preload</a></code>, <code title=attr-media-autoplay><a href=#attr-media-autoplay>autoplay</a></code>,
@@ -31310,9 +31306,18 @@
 
   </div>
 
-  <hr><pre class=idl>enum <dfn id=texttrackmode>TextTrackMode</dfn> { "<a href=#dom-texttrack-disabled title=dom-TextTrack-disabled>disabled</a>", "<a href=#dom-texttrack-hidden title=dom-TextTrack-hidden>hidden</a>", "<a href=#dom-texttrack-showing title=dom-TextTrack-showing>showing</a>" };
+  <hr><pre class=idl>enum <dfn id=texttrackmode>TextTrackMode</dfn> {<!--
+   --> "<a href=#dom-texttrack-disabled title=dom-TextTrack-disabled>disabled</a>", <!--
+   --> "<a href=#dom-texttrack-hidden title=dom-TextTrack-hidden>hidden</a>", <!--
+   --> "<a href=#dom-texttrack-showing title=dom-TextTrack-showing>showing</a>" };
+enum <dfn id=texttrackkind>TextTrackKind</dfn> {<!--
+   --> "<code title=dom-TextTrack-kind-subtitles><a href=#dom-texttrack-kind-subtitles>subtitles</a></code>", <!--
+   --> "<code title=dom-TextTrack-kind-captions><a href=#dom-texttrack-kind-captions>captions</a></code>", <!--
+   --> "<code title=dom-TextTrack-kind-descriptions><a href=#dom-texttrack-kind-descriptions>descriptions</a></code>", <!--
+   --> "<code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code>", <!--
+   --> "<code title=dom-TextTrack-kind-metadata><a href=#dom-texttrack-kind-metadata>metadata</a></code>" };
 interface <dfn id=texttrack>TextTrack</dfn> : <a href=#eventtarget>EventTarget</a> {
-  readonly attribute DOMString <a href=#dom-texttrack-kind title=dom-TextTrack-kind>kind</a>;
+  readonly attribute <a href=#texttrackkind>TextTrackKind</a> <a href=#dom-texttrack-kind title=dom-TextTrack-kind>kind</a>;
   readonly attribute DOMString <a href=#dom-texttrack-label title=dom-TextTrack-label>label</a>;
   readonly attribute DOMString <a href=#dom-texttrack-language title=dom-TextTrack-language>language</a>;
   readonly attribute DOMString <a href=#dom-texttrack-inbandmetadatatrackdispatchtype title=dom-TextTrack-inBandMetadataTrackDispatchType>inBandMetadataTrackDispatchType</a>;
@@ -31402,32 +31407,8 @@
 
   <ol><li>
 
-    <p>If <var title="">kind</var> is not one of the following strings, then throw a
-    <code><a href=#syntaxerror>SyntaxError</a></code> exception and abort these steps:</p>
-
-    <ul class=brief><li><code title=dom-TextTrack-kind-subtitles><a href=#dom-texttrack-kind-subtitles>subtitles</a></code>
-     <li><code title=dom-TextTrack-kind-captions><a href=#dom-texttrack-kind-captions>captions</a></code>
-     <li><code title=dom-TextTrack-kind-descriptions><a href=#dom-texttrack-kind-descriptions>descriptions</a></code>
-     <li><code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code>
-     <li><code title=dom-TextTrack-kind-metadata><a href=#dom-texttrack-kind-metadata>metadata</a></code>
-    </ul></li>
-
    <li>
 
-    <p>If the <var title="">label</var> argument was omitted, let <var title="">label</var> be the
-    empty string.</p>
-
-   </li>
-
-   <li>
-
-    <p>If the <var title="">language</var> argument was omitted, let <var title="">language</var> be
-    the empty string.</p>
-
-   </li>
-
-   <li>
-
     <p>Create a new <code><a href=#texttrack>TextTrack</a></code> object.</p>
 
    </li>
@@ -48737,7 +48718,7 @@
   completely downloaded, each <a href=#concept-task title=concept-task>task</a> that is <a href=#queue-a-task title="queue a
   task">queued</a> by the <a href=#networking-task-source>networking task source</a> while the image is being <a href=#fetch title=fetch>fetched</a> must update the presentation of the image appropriately.</p>
 
-  <p>The user agents should apply the <a href=#content-type-sniffing:-image title="Content-Type sniffing: image">image sniffing
+  <p>The user agent should apply the <a href=#content-type-sniffing:-image title="Content-Type sniffing: image">image sniffing
   rules</a> to determine the type of the image, with the image's <a href=#content-type title=Content-Type>associated Content-Type headers</a> giving the <var title="">official
   type</var>. If these rules are not applied, then the type of the image must be the type given by
   the image's <a href=#content-type title=Content-Type>associated Content-Type headers</a>.</p>
@@ -67140,8 +67121,8 @@
 
     <!-- *********************************** ASYNC BOUNDARY *********************************** -->
 
-    <p>If <var title="">gone async</var> is false, the user agents must return to whatever
-    algorithm invoked the navigation steps and must continue running these steps asynchronously.</p>
+    <p>If <var title="">gone async</var> is false, return to whatever algorithm invoked the
+    navigation steps and continue running these steps asynchronously.</p>
 
    </li>
 
@@ -67546,10 +67527,10 @@
   If such processing is to take place, abort the steps in this section, and jump to <a href=#navigate-non-Document>the next step</a> (labeled "non-document content") in the
   <a href=#navigate>navigate</a> steps above.</p>
 
-  <p>Otherwise, then, with the newly created <code><a href=#document>Document</a></code>, the user agents must
-  <a href=#update-the-session-history-with-the-new-page>update the session history with the new page</a>. User agents may do this before the
-  complete document has been parsed (thus achieving <i>incremental rendering</i>), and must do this
-  before any scripts are to be executed.</p>
+  <p>Otherwise, then, with the newly created <code><a href=#document>Document</a></code>, the user agent must <a href=#update-the-session-history-with-the-new-page>update
+  the session history with the new page</a>. User agents may do this before the complete document
+  has been parsed (thus achieving <i>incremental rendering</i>), and must do this before any scripts
+  are to be executed.</p>
 
   <p>Error messages from the parse process (e.g. XML namespace well-formedness errors) may be
   reported inline by mutating the <code><a href=#document>Document</a></code>.</p>
@@ -73454,8 +73435,8 @@
    <li><p>If this fails, then throw a <code><a href=#syntaxerror>SyntaxError</a></code> exception, aborting the
    method.</li>
 
-   <li><p>If the resoluting <a href=#absolute-url>absolute URL</a>'s <a href=#origin>origin</a> is not the <a href=#same-origin>same
-   origin</a> as that of the <a href=#entry-script>entry script</a> throw a <code><a href=#securityerror>SecurityError</a></code>
+   <li><p>If the resulting <a href=#absolute-url>absolute URL</a>'s <a href=#origin>origin</a> is not the <a href=#same-origin>same
+   origin</a> as that of the <a href=#entry-script>entry script</a>, throw a <code><a href=#securityerror>SecurityError</a></code>
    exception, aborting the method.</li>
 
    <li><p>Return the resulting <a href=#absolute-url>absolute URL</a> as the result of preprocessing the
@@ -82502,7 +82483,7 @@
   lost.</p> <!-- because of the jump-to-entry-point algorithm first step -->
 
   <hr><p>The <dfn id=dom-messageport-close title=dom-MessagePort-close><code>close()</code></dfn> method, when called on a port
-  <var title="">local port</var> that is entangled with another port, must cause the user agents to
+  <var title="">local port</var> that is entangled with another port, must cause the user agent to
   disentangle the two ports. If the method is called on a port that is not entangled, then the
   method must do nothing.</p>
 

Modified: index
===================================================================
--- index	2013-04-11 21:42:13 UTC (rev 7807)
+++ index	2013-04-11 22:00:00 UTC (rev 7808)
@@ -22623,7 +22623,7 @@
   <p class=note>This allows servers to return images with error responses, and have them
   displayed.</p>
 
-  <p>The user agents should apply the <a href=#content-type-sniffing:-image title="Content-Type sniffing: image">image sniffing
+  <p>The user agent should apply the <a href=#content-type-sniffing:-image title="Content-Type sniffing: image">image sniffing
   rules</a> to determine the type of the image, with the image's <a href=#content-type title=Content-Type>associated Content-Type headers</a> giving the <var title="">official
   type</var>. If these rules are not applied, then the type of the image must be the type given by
   the image's <a href=#content-type title=Content-Type>associated Content-Type headers</a>.</p>
@@ -24162,14 +24162,12 @@
  <figcaption>Barney Frank, 2011</figcaption>
 </figure></pre>
 
-  <p class=note>For details on what to put in the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute, see the earlier
-  sections.</p>
+  <p class=note>For details on what to put in the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute,
+  see the earlier sections.</p>
 
-  <p>The problem with this is that the user agent does not necessarily
-  know what dimensions to use for the image when the image is loading.
-  To avoid the layout having to be reflowed multiple times as the page
-  is loading, CSS and CSS media queries can be used to provide the
-  dimensions:</p>
+  <p>The problem with this is that the user agent does not necessarily know what dimensions to use
+  for the image when the image is loading. To avoid the layout having to be reflowed multiple times
+  as the page is loading, CSS and CSS media queries can be used to provide the dimensions:</p>
 
   <pre><figure>
  <style scoped>
@@ -24181,10 +24179,8 @@
  <figcaption>Barney Frank, 2011</figcaption>
 </figure></pre>
 
-  <p>Alternatively, the <code title=attr-dim-width><a href=#attr-dim-width>width</a></code> and
-  <code title=attr-dim-height><a href=#attr-dim-height>height</a></code> attributes can be used
-  to provide the width for legacy user agents, using CSS just for the
-  user agents that support <code title=attr-img-srcset><a href=#attr-img-srcset>srcset</a></code>:</p>
+  <p>Alternatively, the <code title=attr-dim-width><a href=#attr-dim-width>width</a></code> and <code title=attr-dim-height><a href=#attr-dim-height>height</a></code> attributes can be used to provide the width for legacy user
+  agents, using CSS just for the user agents that support <code title=attr-img-srcset><a href=#attr-img-srcset>srcset</a></code>:</p>
 
   <pre><figure>
  <style scoped media="all and (max-width: 600px)">
@@ -26588,7 +26584,7 @@
 
   <div class=example>
 
-   <p>If the author isn't sure if the user agents will all be able to render the media resources
+   <p>If the author isn't sure if user agents will all be able to render the media resources
    provided, the author can listen to the <code title=event-error>error</code> event on the last
    <code><a href=#the-source-element>source</a></code> element and trigger fallback behavior:</p>
 
@@ -26635,7 +26631,7 @@
    <dt><a href=#element-dfn-dom title=element-dfn-dom>DOM interface</a>:</dt><!--TOPIC:DOM APIs-->
    <dd>
 <pre class=idl>interface <dfn id=htmltrackelement>HTMLTrackElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
-           attribute DOMString <a href=#dom-track-kind title=dom-track-kind>kind</a>;
+           attribute <a href=#texttrackkind>TextTrackKind</a> <a href=#dom-track-kind title=dom-track-kind>kind</a>;
            attribute DOMString <a href=#dom-track-src title=dom-track-src>src</a>;
            attribute DOMString <a href=#dom-track-srclang title=dom-track-srclang>srclang</a>;
            attribute DOMString <a href=#dom-track-label title=dom-track-label>label</a>;
@@ -26890,7 +26886,7 @@
   readonly attribute <a href=#audiotracklist>AudioTrackList</a> <a href=#dom-media-audiotracks title=dom-media-audioTracks>audioTracks</a>;
   readonly attribute <a href=#videotracklist>VideoTrackList</a> <a href=#dom-media-videotracks title=dom-media-videoTracks>videoTracks</a>;
   readonly attribute <a href=#texttracklist>TextTrackList</a> <a href=#dom-media-texttracks title=dom-media-textTracks>textTracks</a>;
-  <a href=#texttrack>TextTrack</a> <a href=#dom-media-addtexttrack title=dom-media-addTextTrack>addTextTrack</a>(DOMString kind, optional DOMString label, optional DOMString language);
+  <a href=#texttrack>TextTrack</a> <a href=#dom-media-addtexttrack title=dom-media-addTextTrack>addTextTrack</a>(<a href=#texttrackkind>TextTrackKind</a> kind, optional DOMString label = '', optional DOMString language = '');
 };</pre>
 
   <p>The <dfn id=media-element-attributes>media element attributes</dfn>, <code title=attr-media-src><a href=#attr-media-src>src</a></code>, <code title=attr-media-crossorigin><a href=#attr-media-crossorigin>crossorigin</a></code>, <code title=attr-media-preload><a href=#attr-media-preload>preload</a></code>, <code title=attr-media-autoplay><a href=#attr-media-autoplay>autoplay</a></code>,
@@ -31310,9 +31306,18 @@
 
   </div>
 
-  <hr><pre class=idl>enum <dfn id=texttrackmode>TextTrackMode</dfn> { "<a href=#dom-texttrack-disabled title=dom-TextTrack-disabled>disabled</a>", "<a href=#dom-texttrack-hidden title=dom-TextTrack-hidden>hidden</a>", "<a href=#dom-texttrack-showing title=dom-TextTrack-showing>showing</a>" };
+  <hr><pre class=idl>enum <dfn id=texttrackmode>TextTrackMode</dfn> {<!--
+   --> "<a href=#dom-texttrack-disabled title=dom-TextTrack-disabled>disabled</a>", <!--
+   --> "<a href=#dom-texttrack-hidden title=dom-TextTrack-hidden>hidden</a>", <!--
+   --> "<a href=#dom-texttrack-showing title=dom-TextTrack-showing>showing</a>" };
+enum <dfn id=texttrackkind>TextTrackKind</dfn> {<!--
+   --> "<code title=dom-TextTrack-kind-subtitles><a href=#dom-texttrack-kind-subtitles>subtitles</a></code>", <!--
+   --> "<code title=dom-TextTrack-kind-captions><a href=#dom-texttrack-kind-captions>captions</a></code>", <!--
+   --> "<code title=dom-TextTrack-kind-descriptions><a href=#dom-texttrack-kind-descriptions>descriptions</a></code>", <!--
+   --> "<code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code>", <!--
+   --> "<code title=dom-TextTrack-kind-metadata><a href=#dom-texttrack-kind-metadata>metadata</a></code>" };
 interface <dfn id=texttrack>TextTrack</dfn> : <a href=#eventtarget>EventTarget</a> {
-  readonly attribute DOMString <a href=#dom-texttrack-kind title=dom-TextTrack-kind>kind</a>;
+  readonly attribute <a href=#texttrackkind>TextTrackKind</a> <a href=#dom-texttrack-kind title=dom-TextTrack-kind>kind</a>;
   readonly attribute DOMString <a href=#dom-texttrack-label title=dom-TextTrack-label>label</a>;
   readonly attribute DOMString <a href=#dom-texttrack-language title=dom-TextTrack-language>language</a>;
   readonly attribute DOMString <a href=#dom-texttrack-inbandmetadatatrackdispatchtype title=dom-TextTrack-inBandMetadataTrackDispatchType>inBandMetadataTrackDispatchType</a>;
@@ -31402,32 +31407,8 @@
 
   <ol><li>
 
-    <p>If <var title="">kind</var> is not one of the following strings, then throw a
-    <code><a href=#syntaxerror>SyntaxError</a></code> exception and abort these steps:</p>
-
-    <ul class=brief><li><code title=dom-TextTrack-kind-subtitles><a href=#dom-texttrack-kind-subtitles>subtitles</a></code>
-     <li><code title=dom-TextTrack-kind-captions><a href=#dom-texttrack-kind-captions>captions</a></code>
-     <li><code title=dom-TextTrack-kind-descriptions><a href=#dom-texttrack-kind-descriptions>descriptions</a></code>
-     <li><code title=dom-TextTrack-kind-chapters><a href=#dom-texttrack-kind-chapters>chapters</a></code>
-     <li><code title=dom-TextTrack-kind-metadata><a href=#dom-texttrack-kind-metadata>metadata</a></code>
-    </ul></li>
-
    <li>
 
-    <p>If the <var title="">label</var> argument was omitted, let <var title="">label</var> be the
-    empty string.</p>
-
-   </li>
-
-   <li>
-
-    <p>If the <var title="">language</var> argument was omitted, let <var title="">language</var> be
-    the empty string.</p>
-
-   </li>
-
-   <li>
-
     <p>Create a new <code><a href=#texttrack>TextTrack</a></code> object.</p>
 
    </li>
@@ -48737,7 +48718,7 @@
   completely downloaded, each <a href=#concept-task title=concept-task>task</a> that is <a href=#queue-a-task title="queue a
   task">queued</a> by the <a href=#networking-task-source>networking task source</a> while the image is being <a href=#fetch title=fetch>fetched</a> must update the presentation of the image appropriately.</p>
 
-  <p>The user agents should apply the <a href=#content-type-sniffing:-image title="Content-Type sniffing: image">image sniffing
+  <p>The user agent should apply the <a href=#content-type-sniffing:-image title="Content-Type sniffing: image">image sniffing
   rules</a> to determine the type of the image, with the image's <a href=#content-type title=Content-Type>associated Content-Type headers</a> giving the <var title="">official
   type</var>. If these rules are not applied, then the type of the image must be the type given by
   the image's <a href=#content-type title=Content-Type>associated Content-Type headers</a>.</p>
@@ -67140,8 +67121,8 @@
 
     <!-- *********************************** ASYNC BOUNDARY *********************************** -->
 
-    <p>If <var title="">gone async</var> is false, the user agents must return to whatever
-    algorithm invoked the navigation steps and must continue running these steps asynchronously.</p>
+    <p>If <var title="">gone async</var> is false, return to whatever algorithm invoked the
+    navigation steps and continue running these steps asynchronously.</p>
 
    </li>
 
@@ -67546,10 +67527,10 @@
   If such processing is to take place, abort the steps in this section, and jump to <a href=#navigate-non-Document>the next step</a> (labeled "non-document content") in the
   <a href=#navigate>navigate</a> steps above.</p>
 
-  <p>Otherwise, then, with the newly created <code><a href=#document>Document</a></code>, the user agents must
-  <a href=#update-the-session-history-with-the-new-page>update the session history with the new page</a>. User agents may do this before the
-  complete document has been parsed (thus achieving <i>incremental rendering</i>), and must do this
-  before any scripts are to be executed.</p>
+  <p>Otherwise, then, with the newly created <code><a href=#document>Document</a></code>, the user agent must <a href=#update-the-session-history-with-the-new-page>update
+  the session history with the new page</a>. User agents may do this before the complete document
+  has been parsed (thus achieving <i>incremental rendering</i>), and must do this before any scripts
+  are to be executed.</p>
 
   <p>Error messages from the parse process (e.g. XML namespace well-formedness errors) may be
   reported inline by mutating the <code><a href=#document>Document</a></code>.</p>
@@ -73454,8 +73435,8 @@
    <li><p>If this fails, then throw a <code><a href=#syntaxerror>SyntaxError</a></code> exception, aborting the
    method.</li>
 
-   <li><p>If the resoluting <a href=#absolute-url>absolute URL</a>'s <a href=#origin>origin</a> is not the <a href=#same-origin>same
-   origin</a> as that of the <a href=#entry-script>entry script</a> throw a <code><a href=#securityerror>SecurityError</a></code>
+   <li><p>If the resulting <a href=#absolute-url>absolute URL</a>'s <a href=#origin>origin</a> is not the <a href=#same-origin>same
+   origin</a> as that of the <a href=#entry-script>entry script</a>, throw a <code><a href=#securityerror>SecurityError</a></code>
    exception, aborting the method.</li>
 
    <li><p>Return the resulting <a href=#absolute-url>absolute URL</a> as the result of preprocessing the
@@ -82502,7 +82483,7 @@
   lost.</p> <!-- because of the jump-to-entry-point algorithm first step -->
 
   <hr><p>The <dfn id=dom-messageport-close title=dom-MessagePort-close><code>close()</code></dfn> method, when called on a port
-  <var title="">local port</var> that is entangled with another port, must cause the user agents to
+  <var title="">local port</var> that is entangled with another port, must cause the user agent to
   disentangle the two ports. If the method is called on a port that is not entangled, then the
   method must do nothing.</p>
 

Modified: source
===================================================================
--- source	2013-04-11 21:42:13 UTC (rev 7807)
+++ source	2013-04-11 22:00:00 UTC (rev 7808)
@@ -23673,7 +23673,7 @@
   <p class="note">This allows servers to return images with error responses, and have them
   displayed.</p>
 
-  <p>The user agents should apply the <span title="Content-Type sniffing: image">image sniffing
+  <p>The user agent should apply the <span title="Content-Type sniffing: image">image sniffing
   rules</span> to determine the type of the image, with the image's <span
   title="Content-Type">associated Content-Type headers</span> giving the <var title="">official
   type</var>. If these rules are not applied, then the type of the image must be the type given by
@@ -25370,15 +25370,12 @@
  <figcaption>Barney Frank, 2011</figcaption>
 </figure></pre>
 
-  <p class="note">For details on what to put in the <code
-  title="attr-img-alt">alt</code> attribute, see the earlier
-  sections.</p>
+  <p class="note">For details on what to put in the <code title="attr-img-alt">alt</code> attribute,
+  see the earlier sections.</p>
 
-  <p>The problem with this is that the user agent does not necessarily
-  know what dimensions to use for the image when the image is loading.
-  To avoid the layout having to be reflowed multiple times as the page
-  is loading, CSS and CSS media queries can be used to provide the
-  dimensions:</p>
+  <p>The problem with this is that the user agent does not necessarily know what dimensions to use
+  for the image when the image is loading. To avoid the layout having to be reflowed multiple times
+  as the page is loading, CSS and CSS media queries can be used to provide the dimensions:</p>
 
   <pre><figure>
  <style scoped>
@@ -25390,10 +25387,9 @@
  <figcaption>Barney Frank, 2011</figcaption>
 </figure></pre>
 
-  <p>Alternatively, the <code title="attr-dim-width">width</code> and
-  <code title="attr-dim-height">height</code> attributes can be used
-  to provide the width for legacy user agents, using CSS just for the
-  user agents that support <code
+  <p>Alternatively, the <code title="attr-dim-width">width</code> and <code
+  title="attr-dim-height">height</code> attributes can be used to provide the width for legacy user
+  agents, using CSS just for the user agents that support <code
   title="attr-img-srcset">srcset</code>:</p>
 
   <pre><figure>
@@ -28088,7 +28084,7 @@
 
   <div class="example">
 
-   <p>If the author isn't sure if the user agents will all be able to render the media resources
+   <p>If the author isn't sure if user agents will all be able to render the media resources
    provided, the author can listen to the <code title="event-error">error</code> event on the last
    <code>source</code> element and trigger fallback behavior:</p>
 
@@ -28134,7 +28130,7 @@
    <dt><span title="element-dfn-dom">DOM interface</span>:</dt><!--TOPIC:DOM APIs-->
    <dd>
 <pre class="idl">interface <dfn>HTMLTrackElement</dfn> : <span>HTMLElement</span> {
-           attribute DOMString <span title="dom-track-kind">kind</span>;
+           attribute <span>TextTrackKind</span> <span title="dom-track-kind">kind</span>;
            attribute DOMString <span title="dom-track-src">src</span>;
            attribute DOMString <span title="dom-track-srclang">srclang</span>;
            attribute DOMString <span title="dom-track-label">label</span>;
@@ -28437,7 +28433,7 @@
   readonly attribute <span>AudioTrackList</span> <span title="dom-media-audioTracks">audioTracks</span>;
   readonly attribute <span>VideoTrackList</span> <span title="dom-media-videoTracks">videoTracks</span>;
   readonly attribute <span>TextTrackList</span> <span title="dom-media-textTracks">textTracks</span>;
-  <span>TextTrack</span> <span title="dom-media-addTextTrack">addTextTrack</span>(DOMString kind, optional DOMString label, optional DOMString language);
+  <span>TextTrack</span> <span title="dom-media-addTextTrack">addTextTrack</span>(<span>TextTrackKind</span> kind, optional DOMString label = '', optional DOMString language = '');
 };</pre>
 
   <p>The <dfn>media element attributes</dfn>, <code title="attr-media-src">src</code>, <code
@@ -33644,9 +33640,18 @@
 
   <hr>
 
-  <pre class="idl">enum <dfn>TextTrackMode</dfn> { "<span title="dom-TextTrack-disabled">disabled</span>", "<span title="dom-TextTrack-hidden">hidden</span>", "<span title="dom-TextTrack-showing">showing</span>" };
+  <pre class="idl">enum <dfn>TextTrackMode</dfn> {<!--
+   --> "<span title="dom-TextTrack-disabled">disabled</span>", <!--
+   --> "<span title="dom-TextTrack-hidden">hidden</span>", <!--
+   --> "<span title="dom-TextTrack-showing">showing</span>" };
+enum <dfn>TextTrackKind</dfn> {<!--
+   --> "<code title="dom-TextTrack-kind-subtitles">subtitles</code>", <!--
+   --> "<code title="dom-TextTrack-kind-captions">captions</code>", <!--
+   --> "<code title="dom-TextTrack-kind-descriptions">descriptions</code>", <!--
+   --> "<code title="dom-TextTrack-kind-chapters">chapters</code>", <!--
+   --> "<code title="dom-TextTrack-kind-metadata">metadata</code>" };
 interface <dfn>TextTrack</dfn> : <span>EventTarget</span> {
-  readonly attribute DOMString <span title="dom-TextTrack-kind">kind</span>;
+  readonly attribute <span>TextTrackKind</span> <span title="dom-TextTrack-kind">kind</span>;
   readonly attribute DOMString <span title="dom-TextTrack-label">label</span>;
   readonly attribute DOMString <span title="dom-TextTrack-language">language</span>;
   readonly attribute DOMString <span title="dom-TextTrack-inBandMetadataTrackDispatchType">inBandMetadataTrackDispatchType</span>;
@@ -33745,35 +33750,8 @@
 
    <li>
 
-    <p>If <var title="">kind</var> is not one of the following strings, then throw a
-    <code>SyntaxError</code> exception and abort these steps:</p>
-
-    <ul class="brief">
-     <li><code title="dom-TextTrack-kind-subtitles">subtitles</code>
-     <li><code title="dom-TextTrack-kind-captions">captions</code>
-     <li><code title="dom-TextTrack-kind-descriptions">descriptions</code>
-     <li><code title="dom-TextTrack-kind-chapters">chapters</code>
-     <li><code title="dom-TextTrack-kind-metadata">metadata</code>
-    </ul>
-
-   </li>
-
    <li>
 
-    <p>If the <var title="">label</var> argument was omitted, let <var title="">label</var> be the
-    empty string.</p>
-
-   </li>
-
-   <li>
-
-    <p>If the <var title="">language</var> argument was omitted, let <var title="">language</var> be
-    the empty string.</p>
-
-   </li>
-
-   <li>
-
     <p>Create a new <code>TextTrack</code> object.</p>
 
    </li>
@@ -57899,7 +57877,7 @@
   task">queued</span> by the <span>networking task source</span> while the image is being <span
   title="fetch">fetched</span> must update the presentation of the image appropriately.</p>
 
-  <p>The user agents should apply the <span title="Content-Type sniffing: image">image sniffing
+  <p>The user agent should apply the <span title="Content-Type sniffing: image">image sniffing
   rules</span> to determine the type of the image, with the image's <span
   title="Content-Type">associated Content-Type headers</span> giving the <var title="">official
   type</var>. If these rules are not applied, then the type of the image must be the type given by
@@ -79457,8 +79435,8 @@
 
     <!-- *********************************** ASYNC BOUNDARY *********************************** -->
 
-    <p>If <var title="">gone async</var> is false, the user agents must return to whatever
-    algorithm invoked the navigation steps and must continue running these steps asynchronously.</p>
+    <p>If <var title="">gone async</var> is false, return to whatever algorithm invoked the
+    navigation steps and continue running these steps asynchronously.</p>
 
    </li>
 
@@ -79919,10 +79897,10 @@
   href="#navigate-non-Document">the next step</a> (labeled "non-document content") in the
   <span>navigate</span> steps above.</p>
 
-  <p>Otherwise, then, with the newly created <code>Document</code>, the user agents must
-  <span>update the session history with the new page</span>. User agents may do this before the
-  complete document has been parsed (thus achieving <i>incremental rendering</i>), and must do this
-  before any scripts are to be executed.</p>
+  <p>Otherwise, then, with the newly created <code>Document</code>, the user agent must <span>update
+  the session history with the new page</span>. User agents may do this before the complete document
+  has been parsed (thus achieving <i>incremental rendering</i>), and must do this before any scripts
+  are to be executed.</p>
 
   <p>Error messages from the parse process (e.g. XML namespace well-formedness errors) may be
   reported inline by mutating the <code>Document</code>.</p>
@@ -86764,8 +86742,8 @@
    <li><p>If this fails, then throw a <code>SyntaxError</code> exception, aborting the
    method.</p></li>
 
-   <li><p>If the resoluting <span>absolute URL</span>'s <span>origin</span> is not the <span>same
-   origin</span> as that of the <span>entry script</span> throw a <code>SecurityError</code>
+   <li><p>If the resulting <span>absolute URL</span>'s <span>origin</span> is not the <span>same
+   origin</span> as that of the <span>entry script</span>, throw a <code>SecurityError</code>
    exception, aborting the method.</p></li>
 
    <li><p>Return the resulting <span>absolute URL</span> as the result of preprocessing the
@@ -96611,7 +96589,7 @@
   <hr>
 
   <p>The <dfn title="dom-MessagePort-close"><code>close()</code></dfn> method, when called on a port
-  <var title="">local port</var> that is entangled with another port, must cause the user agents to
+  <var title="">local port</var> that is entangled with another port, must cause the user agent to
   disentangle the two ports. If the method is called on a port that is not entangled, then the
   method must do nothing.</p>
 




More information about the Commit-Watchers mailing list