[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