added heading for default splash screen file
authorMarcos Caceres <>
Wed, 07 Dec 2011 01:15:18 +0000
changeset 11 3bfc8f2a077b
parent 10 95abb12bde9a
child 12 177ab409ca88
added heading for default splash screen file
--- 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 @@
 <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>
-   <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>
-   <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>
-<h2 id=open-questions><span class=secno>1 </span>Open Questions</h2>
-  <li>Do we want a magic file "splash.png" for instance? </li>
-  <li></li>
-<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>
-<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>&lt;widget xmlns=""&gt; 
-   &lt;content splash="splash.png"/&gt; 
+   &lt;content splash="logo.png"/&gt; 
 <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>
-<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 @@
 <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=>Table of Configuration Defaults</a> in <a href=>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.">
@@ -177,14 +172,17 @@
-<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=>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>
+    <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 @@
-<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>
\ No newline at end of file