--- a/splashscreen/Overview.html Wed Dec 07 01:15:07 2011 +0000
+++ b/splashscreen/Overview.html Wed Dec 07 01:15:18 2011 +0000
@@ -72,58 +72,53 @@
<!--begin-toc-->
<ol class=toc>
- <li><a href=#open-questions><span class=secno>1 </span>Open Questions</a></li>
- <li><a href=#status-of-this-document><span class=secno>2 </span>Status of this document</a></li>
- <li><a href=#introduction><span class=secno>3 </span>Introduction</a>
+ <li><a href=#status-of-this-document><span class=secno>1 </span>Status of this document</a></li>
+ <li><a href=#introduction><span class=secno>2 </span>Introduction</a>
<ol>
- <li><a href=#example><span class=secno>3.1 </span>Example</a></li></ol></li>
- <li><a href=#use-cases-and-requirements><span class=secno>4 </span>Use cases and requirements</a></li>
- <li><a href=#conformance><span class=secno>5 </span>Conformance</a></li>
- <li><a href=#user-agents><span class=secno>6 </span>User Agents</a></li>
- <li><a href=#splash-screen><span class=secno>7 </span>Splash screen</a></li>
- <li><a href=#rendering-the-splash-screen><span class=secno>8 </span>Rendering the splash screen </a></li>
- <li><a href=#the-splash-attribute><span class=secno>9 </span>The <code>splash</code> attribute</a></li>
- <li><a href=#the-default-splash-screen><span class=secno>10 </span>The default splash screen</a></li>
- <li><a href=#processing-the-splash-attribute><span class=secno>11 </span>Processing the splash attribute</a>
+ <li><a href=#example:-using-the-default-splash-screen-file><span class=secno>2.1 </span>Example: using the default splash screen file</a></li>
+ <li><a href=#example:-using-the-content-element><span class=secno>2.2 </span>Example: using the content element</a></li></ol></li>
+ <li><a href=#use-cases-and-requirements><span class=secno>3 </span>Use cases and requirements</a></li>
+ <li><a href=#conformance><span class=secno>4 </span>Conformance</a></li>
+ <li><a href=#user-agents><span class=secno>5 </span>User Agents</a></li>
+ <li><a href=#splash-screen><span class=secno>6 </span>Splash screen</a></li>
+ <li><a href=#the-splash-attribute><span class=secno>7 </span>The <code>splash</code> attribute</a></li>
+ <li><a href=#the-default-splash-screen><span class=secno>8 </span>The default splash screen</a></li>
+ <li><a href=#finding-the-splash-screen><span class=secno>9 </span>Finding the splash screen</a>
<ol>
- <li><a href=#locating-the-splash-screen><span class=secno>11.1 </span>Locating the splash screen</a></li>
- <li><a class="no-num done" href=#locate-the-default-splash-screen-file>Locate the default splash screen file</a></li></ol></li></ol>
+ <li><a href=#processing-the-splash-attribute><span class=secno>9.1 </span>Processing the splash attribute</a></li>
+ <li><a class="no-num done" href=#locate-the-default-splash-screen-file>Locate the default splash screen file</a></li></ol></li>
+ <li><a href=#rendering-the-splash-screen><span class=secno>10 </span>Rendering the splash screen </a></li></ol>
<!--end-toc-->
-<h2 id=open-questions><span class=secno>1 </span>Open Questions</h2>
-<ul>
- <li>Do we want a magic file "splash.png" for instance? </li>
- <li></li>
-</ul>
-<h2 id=status-of-this-document><span class=secno>2 </span>Status of this document</h2>
+<h2 id=status-of-this-document><span class=secno>1 </span>Status of this document</h2>
<p>This document is undergoing rapid development and is changing frequently. It is inappropriate to cite this document as anything other than a work in progress. </p>
-<h2 id=introduction><span class=secno>3 </span>Introduction</h2>
+<h2 id=introduction><span class=secno>2 </span>Introduction</h2>
<p><em>This section is non-normative.</em></p>
<p>TBW</p>
-<h3 id=example><span class=secno>3.1 </span>Example</h3>
+<h3 id=example:-using-the-default-splash-screen-file><span class=secno>2.1 </span>Example: using the default splash screen file</h3>
+<p> </p>
+<h3 id=example:-using-the-content-element><span class=secno>2.2 </span>Example: using the content element</h3>
<p>The following example shows how to use the <code>splash</code> attribute. </p>
<pre><widget xmlns="http://www.w3.org/ns/widgets">
- <content splash="splash.png"/>
+ <content splash="logo.png"/>
</widget>
</pre>
<p>Might appear as the following in a conforming user agent: </p>
<p><img alt="Loading screen" height=228 src=images/device_portrait.png width=209></p>
-<h2 id=use-cases-and-requirements><span class=secno>4 </span>Use cases and requirements</h2>
+<h2 id=use-cases-and-requirements><span class=secno>3 </span>Use cases and requirements</h2>
<p><em>This section is non-normative.</em></p>
<p>TBW</p>
-<h2 id=conformance><span class=secno>5 </span>Conformance</h2>
+<h2 id=conformance><span class=secno>4 </span>Conformance</h2>
<p>Everything is this specification is normative except sections marked as non-normative, diagrams, examples, and notes.</p>
<p>The key words <em class=rfc2119 title=must>must</em>, <em class=rfc2119 title="must not">must not</em>, <em class=rfc2119 title=required>required</em>, <em class=rfc2119 title=should>should</em>, <em class=rfc2119 title="should not">should not</em>, <em class=rfc2119 title=recommended>recommended</em>, <em class=rfc2119 title=may>may</em>, and <em class=rfc2119 title=optional>optional</em> in this specification are to be interpreted as described in <cite>RFC2119</cite>.</p>
<p> This specification defines conformance criteria that apply to a single product: a <a href=#product-ua>user agent</a>. </p>
-<h2 id=user-agents><span class=secno>6 </span>User Agents</h2>
+<h2 id=user-agents><span class=secno>5 </span>User Agents</h2>
<p>A <dfn id=product-ua title="user agent">user agent</dfn> a software application that implements this specification and
the <cite>Widget Packaging</cite> specification and its dependencies. </p>
-<h2 id=splash-screen><span class=secno>7 </span>Splash screen</h2>
+<h2 id=splash-screen><span class=secno>6 </span>Splash screen</h2>
<p>TBW: define what splash screen is.</p>
-<h2 id=rendering-the-splash-screen><span class=secno>8 </span>Rendering the splash screen </h2>
-<p>TBW: We should provide some non-normative guidelines. </p>
-<h2 id=the-splash-attribute><span class=secno>9 </span>The <code>splash</code> attribute</h2>
+<h2 id=the-splash-attribute><span class=secno>7 </span>The <code>splash</code> attribute</h2>
<p>The <dfn id=splash-attribute>splash attribute</dfn> is <span>path attribute</span> of the <code>content</code> element that allows an author to point to a <span>file</span> within the <span>widget package</span>. This file is then used as the splash screen for an application. </p>
-<h2 id=the-default-splash-screen><span class=secno>10 </span>The default splash screen</h2>
+<h2 id=the-default-splash-screen><span class=secno>8 </span>The default splash screen</h2>
<p>A <dfn id=default-splash-screen>default splash-screen </dfn> is a <span>reserved</span> <span>image</span>, either at the <span>root of the widget package</span> or at the root of a <span>locale
folder</span>, whose file
name case-sensitively and exactly matches a file name given in the file name column of
@@ -154,7 +149,7 @@
</tr>
</tbody></table>
<p>It is <em class=ct>optional</em> for a <a href=#product-ua>user agent</a> to <span title=supported>support</span> the <span title="media type">media types</span> listed in the <a href=#default-splash-screen-table>default splash-screen table</a>.</p>
-<h2 id=processing-the-splash-attribute><span class=secno>11 </span>Processing the splash attribute</h2>
+<h2 id=finding-the-splash-screen><span class=secno>9 </span>Finding the splash screen</h2>
<p>Firstly, when processing the splash attribute in the configuration document, a user agent behaves as if the <a href=#splash-file-defaults-table>splash file defaults table</a> had been defined as part of the <a href=http://www.w3.org/TR/widgets/#table-of-configuration-defaults>Table of Configuration Defaults</a> in <a href=http://dev.w3.org/2006/waf/widgets/#step-3--set-the-configuration-defaults>Step 3</a> of the <cite>Widget Packaging</cite> specification.</p>
<table class=simple style="border: 1px solid black" summary="The configuration defaults that a user agent must set prior to instantiation.">
<caption>
@@ -177,14 +172,17 @@
</tr>
</tbody>
</table>
-<p>Secondly, the user agent MUST run the <a href=#steps-to-locate-the-splash-screen-file>steps to locate the splash screen file</a> at
+<p>Secondly, the user agent MUST run the <a href=#steps-to-process-the-splash-attribute>steps to process the <code>splash</code> attribute</a> at
the appropriate point in the <a href=http://dev.w3.org/2006/waf/widgets/#algorithm-to-process-a-configuration-doc>algorithm to process a
-configuration document</a>: the appropriate point is after all other attributes of the <code>content</code> element have been processed. </p>
-<p>Thirdly, if no splash screen file was found by running the <a href=#steps-to-locate-the-splash-screen-file>steps to locate the splash screen file</a>, the user agent MUST attempt to locate </p>
-<h3 id=locating-the-splash-screen><span class=secno>11.1 </span>Locating the splash screen</h3>
-<p>The <dfn id=steps-to-locate-the-splash-screen-file>steps to locate the splash screen file</dfn> is given by the following algorithm. </p>
+configuration document</a>: the appropriate point is after all other attributes of the <code>content</code> element defined in the Widgets Packaging specification have been processed by the user agent. </p>
+<p>Thirdly, if no splash screen file was found by running the <span>steps to locate the splash screen file</span>, the user agent MUST attempt to locate </p>
+<h3 id=processing-the-splash-attribute><span class=secno>9.1 </span>Processing the splash attribute</h3>
+<p>The <dfn id=steps-to-process-the-splash-attribute>steps to process the splash attribute</dfn> is given by the following algorithm. </p>
<ol>
<li>
+ <p>If the content element does not have an attribute whose name is "splash", then terminate this algorithm. </p>
+ </li>
+ <li>
<p>Let <var>path</var> be the result of applying the <span>rule for getting a
single attribute value</span> to the <code title="icon src">splash</code> attribute of this <code title="icon element">content</code> element. If <var>path</var> is
not a <span>valid path</span> or is an empty string, then terminate this algorithm. </p>
@@ -222,7 +220,8 @@
</ol>
</li>
</ol>
-<p> </p>
+<h2 id=rendering-the-splash-screen><span class=secno>10 </span>Rendering the splash screen </h2>
+<p>TBW: We should provide some non-normative guidelines.</p>
</body></html>
\ No newline at end of file