--- a/splashscreen/Overview.src.html Wed Dec 07 00:38:37 2011 +0000
+++ b/splashscreen/Overview.src.html Wed Dec 07 01:13:15 2011 +0000
@@ -74,21 +74,17 @@
<p>TBW... </p>
<h2 class="no-num no-toc">Table of Contents</h2>
<!--toc-->
-<h2>Open Questions</h2>
-<ul>
- <li>Do we want a magic file "splash.png" for instance? </li>
- <li></li>
-</ul>
<h2>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>Introduction</h2>
<p><em>This section is non-normative.</em></p>
<p>TBW</p>
-<h3>Example</h3>
+<h3>Example </h3>
+<h3>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>
@@ -105,8 +101,6 @@
the <cite>Widget Packaging</cite> specification and its dependencies. </p>
<h2>Splash screen</h2>
<p>TBW: define what splash screen is.</p>
-<h2>Rendering the splash screen </h2>
-<p>TBW: We should provide some non-normative guidelines. </p>
<h2>The <code>splash</code> attribute</h2>
<p>The <dfn>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>The default splash screen</h2>
@@ -140,7 +134,7 @@
</tr>
</table>
<p>It is <em class="ct">optional</em> for a <span>user agent</span> to <span title="supported">support</span> the <span title="media type">media types</span> listed in the <span>default splash-screen table</span>.</p>
-<h2>Processing the splash attribute</h2>
+<h2>Finding the splash screen</h2>
<p>Firstly, when processing the splash attribute in the configuration document, a user agent behaves as if the <span>splash file defaults table</span> 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 summary="The configuration defaults that a user agent must set prior to instantiation." class="simple" style="border: 1px solid black">
<caption>
@@ -163,14 +157,17 @@
</tr>
</tbody>
</table>
-<p>Secondly, the user agent MUST run the <span>steps to locate the splash screen file</span> at
+<p>Secondly, the user agent MUST run the <span>steps to process the <code>splash</code> attribute</span> 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>
+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>Locating the splash screen</h3>
-<p>The <dfn>steps to locate the splash screen file</dfn> is given by the following algorithm. </p>
+<h3>Processing the splash attribute</h3>
+<p>The <dfn>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>
@@ -208,6 +205,7 @@
</ol>
</li>
</ol>
-<p> </p>
+<h2>Rendering the splash screen </h2>
+<p>TBW: We should provide some non-normative guidelines.</p>
</body>
</html>