cleaned up a bit ... added some more text
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/splashscreen/Overview.html Tue Dec 06 19:37:09 2011 +0000
@@ -0,0 +1,149 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns=http://www.w3.org/1999/xhtml><head>
+<meta content="text/html; charset=UTF-8" http-equiv=Content-Type>
+<title>Splash screen</title>
+<style type=text/css>
+em.ct {
+ text-transform:uppercase;
+ font-style:normal;
+ font-weight:normal;
+}
+em.ct-samp {
+ text-transform:uppercase;
+ font-style:normal;
+ font-weight:normal;
+}
+a.bibref {
+ text-decoration: none;
+}
+em.rfc2119 {
+ text-transform: lowercase;
+ font-variant: small-caps;
+ font-style: normal;
+ color: #900;
+}
+</style>
+<link href=http://www.w3.org/StyleSheets/TR/base rel=stylesheet type=text/css>
+<style type=text/css>
+a.internalDFN { color: inherit;
+ border-bottom: 1px solid #99c;
+ text-decoration: none;
+}
+</style>
+</head>
+
+<body>
+<div class=head><!--end-logo-->
+ <h1>Splash screen </h1>
+ <dl>
+ <dt>Latest Draft:</dt>
+ <dd><a href=http://dvcs.w3.org/hg/nativeapps/splashscreen/raw-file/tip/Overview.src.html>http://dvcs.w3.org/hg/nativeapps/splashscreen/raw-file/tip/Overview.src.html</a></dd>
+ <dt>Test suite:</dt>
+ <dd><a href=http://dev.w3.org/2006/waf/widgets/test-suite/>http://test.w3.org/nativeapps/splashscreen/test-suite/</a></dd>
+ <dt>Implementation report:</dt>
+ <dd><a href=http://test.w3.org/nativeapps/splashscreen/test-suite/>http://test.w3.org/nativeapps/splashscreen/imp-report/</a> </dd>
+ <dt>Editor: </dt>
+ <dd>Marcos Cáceres</dd>
+ <dt>Prototypists:</dt>
+ <dd>Brian LeRoux, Scott Wilson</dd>
+ <dt>Quality assurer:</dt>
+ <dd>Marcos Cáceres</dd>
+ <dt>Provenence:</dt>
+ <dd><a href=http://lists.w3.org/Archives/Public/public-native-web-apps/2011Dec/0002.html>Call for Concensus </a></dd>
+ </dl>
+
+ <p class=copyright><a href=http://creativecommons.org/publicdomain/zero/1.0/ rel=license><img alt=CC0 src=http://i.creativecommons.org/p/zero/1.0/80x15.png></a>
+To the extent possible under law, the editors have waived all copyright and
+related or neighboring rights to this work. In addition, as of
+6 December 2011, the editors have made this specification available
+under the
+<a href=http://www.openwebfoundation.org/legal/the-owf-1-0-agreements/owfa-1-0 rel=license>Open Web Foundation Agreement Version 1.0</a>,
+which is available at
+http://www.openwebfoundation.org/legal/the-owf-1-0-agreements/owfa-1-0.
+<!-- XXX
+When published on W3C TR, the following paragraph applies as well.
+-->
+<!-- XXX copyright-->
+</p></div>
+
+
+<h2 class="no-num no-toc" id=toc>Abstract</h2>
+<p>TBW... </p>
+<h2 class="no-num no-toc" id=table-of-contents>Table of Contents</h2>
+
+<!--begin-toc-->
+<ol class=toc>
+ <li><a href=#introduction><span class=secno>1 </span>Introduction</a></li>
+ <li><a href=#use-cases-and-requirements><span class=secno>2 </span>Use cases and requirements</a></li>
+ <li><a href=#conformance><span class=secno>3 </span>Conformance</a></li>
+ <li><a href=#user-agents><span class=secno>4 </span>User Agents</a></li>
+ <li><a href=#splash-screen><span class=secno>5 </span>Splash screen</a></li>
+ <li><a href=#the-splash-attribute><span class=secno>6 </span>The <code>splash</code> attribute</a></li>
+ <li><a href=#processing-the-splash-attribute><span class=secno>7 </span>Processing the splash attribute</a>
+ <ol>
+ <li><a href=#locating-the-splash-screen><span class=secno>7.1 </span>Locating the splash screen</a></li></ol></li></ol>
+<!--end-toc-->
+<h2 id=introduction><span class=secno>1 </span>Introduction</h2>
+<p><em>This section is non-normative.</em></p>
+<p>TBW</p>
+<h2 id=use-cases-and-requirements><span class=secno>2 </span>Use cases and requirements</h2>
+<p><em>This section is non-normative.</em></p>
+<p>TBW</p>
+<h2 id=conformance><span class=secno>3 </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>4 </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>5 </span>Splash screen</h2>
+<p>TBW: define what splash screen is. </p>
+<h2 id=the-splash-attribute><span class=secno>6 </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=processing-the-splash-attribute><span class=secno>7 </span>Processing the splash attribute</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 summary="The configuration defaults that a user agent must set prior to instantiation.">
+ <caption>
+ <dfn id=splash-file-defaults-table>Splash file defaults table</dfn>
+ </caption>
+ <thead>
+ <tr>
+ <th scope=col>Variable</th>
+ <th scope=col>Type</th>
+ <th scope=col>Default Value</th>
+ <th scope=col>Overridden in</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <th scope=row><dfn id=dfn-access-request-list><var>splash file</var></dfn></th>
+ <td>path</td>
+ <td><code>null</code></td>
+ <td><a href=http://dev.w3.org/2006/waf/widgets/#step-7--process-the-configuration-docume>Step 7</a></td>
+ </tr>
+ </tbody>
+</table>
+<p>Secondly, the user agent MUST run the steps to locate the splash screen file 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 at the end of where the algorithm processes a <code>content</code> element (i.e., after all other attributes of the element have been processed in accordance with the <cite>Widget Packaging</cite> specification). </p>
+<h3 id=locating-the-splash-screen><span class=secno>7.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>
+<ol>
+ <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>
+ </li>
+ <li>
+ <p> Let <var title="">file</var> be the result of applying the <span>rule for
+
+ finding a file within a widget package</span> to <var>path</var>. If <var title="">file</var> is not a <span>processable file</span>, as
+ determined by applying the <span>rule for identifying the media type of a
+ file</span>, then terminate this algorithm.
+ </p>
+
+ </li>
+ <li>Otherwise, if the file is a processable file, then let <a href=#dfn-access-request-list><var>splash file</var></a> be file.</li>
+</ol>
+
+
+</body></html>
\ No newline at end of file
--- a/splashscreen/Overview.src.html Tue Dec 06 17:33:18 2011 +0000
+++ b/splashscreen/Overview.src.html Tue Dec 06 19:37:09 2011 +0000
@@ -4,70 +4,137 @@
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Splash screen</title>
<style type="text/css">
-em.ct { text-transform:uppercase;
+em.ct {
+ text-transform:uppercase;
font-style:normal;
font-weight:normal;
}
-em.ct-samp { text-transform:uppercase;
+em.ct-samp {
+ text-transform:uppercase;
font-style:normal;
font-weight:normal;
}
-a.bibref { text-decoration: none;
+a.bibref {
+ text-decoration: none;
}
-em.rfc2119 { text-transform: lowercase;
+em.rfc2119 {
+ text-transform: lowercase;
font-variant: small-caps;
font-style: normal;
color: #900;
}
</style>
+<link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/base"/>
+<style type="text/css">
+a.internalDFN { color: inherit;
+ border-bottom: 1px solid #99c;
+ text-decoration: none;
+}
+</style>
</head>
<body>
-<dl class="procedure">
-<dd>
- <div class="head">
- <p><a href="http://www.w3.org/"><img alt="W3C" src="http://www.w3.org/Icons/w3c_home"
- height="48" width="72" /></a></p>
- <!--end-logo-->
- <h1 class="head">Splash screen </h1>
- <dl>
- <dt>Latest Draft:</dt>
- <dd>HG Repo. </dd>
- <dt>Test suite:</dt>
- <dd><a href=
+<div class="head"><!--end-logo-->
+ <h1>Splash screen </h1>
+ <dl>
+ <dt>Latest Draft:</dt>
+ <dd><a href="http://dvcs.w3.org/hg/nativeapps/splashscreen/raw-file/tip/Overview.src.html">http://dvcs.w3.org/hg/nativeapps/splashscreen/raw-file/tip/Overview.src.html</a></dd>
+ <dt>Test suite:</dt>
+ <dd><a href=
"http://dev.w3.org/2006/waf/widgets/test-suite/">http://test.w3.org/nativeapps/splashscreen/test-suite/</a></dd>
- <dt>Implementation report:</dt>
- <dd><a href=
+ <dt>Implementation report:</dt>
+ <dd><a href=
"http://test.w3.org/nativeapps/splashscreen/test-suite/">http://test.w3.org/nativeapps/splashscreen/imp-report/</a> </dd>
- </dl>
- </div>
- <h2 class="no-num no-toc" id="toc">Abstract</h2>
- <h2 class="no-num no-toc">Table of Contents</h2>
- <!--toc-->
- <h2>Introduction</h2>
- <p><em>This section is non-normative.</em></p>
- <p>TBW</p>
- <h2>Use cases and requirements</h2>
- <p><em>This section is non-normative.</em></p>
- <p>TBW</p>
- <h2 id="conformance">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 <span>user agent</span>. </p>
- <h2>User Agents</h2>
- <p>A <dfn id="product-ua" title="user agent">user agent</dfn> a software application that implements this specification and
+ <dt>Editor: </dt>
+ <dd>Marcos Cáceres</dd>
+ <dt>Prototypists:</dt>
+ <dd>Brian LeRoux, Scott Wilson</dd>
+ <dt>Quality assurer:</dt>
+ <dd>Marcos Cáceres</dd>
+ <dt>Provenence:</dt>
+ <dd><a href="http://lists.w3.org/Archives/Public/public-native-web-apps/2011Dec/0002.html">Call for Concensus </a></dd>
+ </dl>
+
+ <p class="copyright"><a href="http://creativecommons.org/publicdomain/zero/1.0/" rel="license"><img alt="CC0" src="http://i.creativecommons.org/p/zero/1.0/80x15.png"></a>
+To the extent possible under law, the editors have waived all copyright and
+related or neighboring rights to this work. In addition, as of
+[DATE], the editors have made this specification available
+under the
+<a href="http://www.openwebfoundation.org/legal/the-owf-1-0-agreements/owfa-1-0" rel="license">Open Web Foundation Agreement Version 1.0</a>,
+which is available at
+http://www.openwebfoundation.org/legal/the-owf-1-0-agreements/owfa-1-0.
+<!-- XXX
+When published on W3C TR, the following paragraph applies as well.
+-->
+<!-- XXX copyright-->
+</div>
+
+</div>
+<h2 class="no-num no-toc" id="toc">Abstract</h2>
+<p>TBW... </p>
+<h2 class="no-num no-toc">Table of Contents</h2>
+<!--toc-->
+<h2>Introduction</h2>
+<p><em>This section is non-normative.</em></p>
+<p>TBW</p>
+<h2>Use cases and requirements</h2>
+<p><em>This section is non-normative.</em></p>
+<p>TBW</p>
+<h2 id="conformance">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 <span>user agent</span>. </p>
+<h2>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>Locating the splash screen</h2>
-
- <p>The algorithm to locate the splash screen file is as follows. The algorithm returns a file is a splash screen file is found: </p>
+<h2>Splash screen</h2>
+<p>TBW: define what splash screen is. </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>Processing the splash attribute</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">
+ <caption>
+ <dfn>Splash file defaults table</dfn>
+ </caption>
+ <thead>
+ <tr>
+ <th scope="col">Variable</th>
+ <th scope="col">Type</th>
+ <th scope="col">Default Value</th>
+ <th scope="col">Overridden in</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <th scope="row"><dfn id="dfn-access-request-list"><var>splash file</var></dfn></th>
+ <td>path</td>
+ <td><code>null</code></td>
+ <td><a href="http://dev.w3.org/2006/waf/widgets/#step-7--process-the-configuration-docume">Step 7</a></td>
+ </tr>
+ </tbody>
+</table>
+<p>Secondly, the user agent MUST run the steps to locate the splash screen file 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 at the end of where the algorithm processes a <code>content</code> element (i.e., after all other attributes of the element have been processed in accordance with the <cite>Widget Packaging</cite> specification). </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>
+<ol>
+ <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>
- Let <var title="">file</var> be the result of applying the <span>rule for
+ not a <span>valid path</span> or is an empty string, then terminate this algorithm. </p>
+ </li>
+ <li>
+ <p> Let <var title="">file</var> be the result of applying the <span>rule for
finding a file within a widget package</span> to <var>path</var>. If <var title="">file</var> is not a <span>processable file</span>, as
- determined by applying the <span>rule for identifying the media type of a
- file</span>, then terminate this algorithm. </p>
+ determined by applying the <span>rule for identifying the media type of a
+ file</span>, then terminate this algorithm.
+ </p>
+ </li>
+ <li>Otherwise, if the file is a processable file, then let <var>splash file</var> be file.</li>
+</ol>
</body>
</html>