- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 29 Mar 2010 20:44:01 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/markup/elements
In directory hutz:/tmp/cvs-serv30668/elements
Modified Files:
audio.html menu.html video.html
Log Message:
correctly document the allowed values for the preload attribute (thx=Simon)
Index: audio.html
===================================================================
RCS file: /sources/public/html5/markup/elements/audio.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- audio.html 25 Feb 2010 10:30:47 -0000 1.11
+++ audio.html 29 Mar 2010 20:43:59 -0000 1.12
@@ -24,8 +24,24 @@
</dl>
<dl>
<dt id="audio.attrs.preload">preload</dt>
- <dd>Instructs the UA that downloading the entire audio
- stream optimistically is considered worthwhile.</dd>
+ <dd>Represents a hint to the UA about whether optimistic
+ downloading of the audio stream itself or its
+ metadata is considered worthwhile.
+ <ul>
+ <li>"<span class="attr-values">none</span>": Hints to the UA that the user
+ is not expected to need the video, or that minimizing
+ unnecessary traffic is desirable.</li>
+ <li>"<span class="attr-values">metadata</span>": Hints to the UA
+ that the user is not expected to need the audio stream,
+ but that fetching its metadata (duration and so on) is
+ desirable.</li>
+ <li>"<span class="attr-values">auto</span>": Hints to the UA that
+ optimistically downloading the entire audio stream is
+ considered desirable.</li>
+ </ul>
+ Specifying the empty string is equivalent to specifying
+ the value "<span class="attr-values">auto</span>".
+ </dd>
</dl>
<dl>
<dt id="audio.attrs.autoplay">autoplay</dt>
Index: menu.html
===================================================================
RCS file: /sources/public/html5/markup/elements/menu.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- menu.html 10 Feb 2010 18:47:41 -0000 1.9
+++ menu.html 29 Mar 2010 20:43:59 -0000 1.10
@@ -19,15 +19,15 @@
<div id="attributes">
<dl>
<dt id="menu.attrs.type" class="new">type</dt>
- <dd>The kind of menu being declared. The attribute has three states:
+ <dd>The kind of menu being declared.
<ul>
- <li>If the <code>context</code> keyword is specified,
- the element is declaring a context menu.</li>
- <li>If the <code>toolbar</code> keyword is specified,
- the element is declaring a tool bar.</li>
- <li>If the attribute is omitted, the element is a list of
- commands that is neither declaring a context menu nor
- defining a tool bar.</li>
+ <li>"<span class="attr-values">toolbar</span>":
+ Indicates that the element represents a tool bar.</li>
+ <li>"<span class="attr-values">context</span>":
+ Indicates that the element represents a context menu.</li>
+ <li>If the attribute is omitted, the element represents
+ a list of commands that is neither a context menu nor a
+ tool bar.</li>
</ul>
</dd>
</dl>
Index: video.html
===================================================================
RCS file: /sources/public/html5/markup/elements/video.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- video.html 25 Feb 2010 10:30:47 -0000 1.9
+++ video.html 29 Mar 2010 20:43:59 -0000 1.10
@@ -37,9 +37,24 @@
</dl>
<dl>
<dt id="video.attrs.preload">preload</dt>
- <dd>Instructs the UA that the author believes that
- downloading the entire video optimistically will be
- worthwhile.</dd>
+ <dd>Represents a hint to the UA about whether optimistic
+ downloading of the video itself or its metadata is
+ considered worthwhile.
+ <ul>
+ <li>"<span class="attr-values">none</span>": Hints to the UA that the user
+ is not expected to need the video, or that minimizing
+ unnecessary traffic is desirable.</li>
+ <li>"<span class="attr-values">metadata</span>": Hints to the UA
+ that the user is not expected to need the video,
+ but that fetching its metadata (dimensions, first frame,
+ track list, duration, and so on) is desirable.</li>
+ <li>"<span class="attr-values">auto</span>": Hints to the UA that
+ optimistically downloading the entire video is
+ considered desirable.</li>
+ </ul>
+ Specifying the empty string is equivalent to specifying
+ the value "<span class="attr-values">auto</span>".
+ </dd>
</dl>
<dl>
<dt id="video.attrs.autoplay">autoplay</dt>
Received on Monday, 29 March 2010 20:44:03 UTC